Social

Search and post to X/Twitter with browser automation.

Overview

Franklin integrates with X/Twitter through browser automation (Playwright) — no X API key required. You can search for posts, draft replies, and post directly from the terminal.

SearchX

Find relevant X/Twitter posts by keyword, topic, or user:

plaintext

You: "Find recent tweets about Base L2"

Franklin: [uses SearchX tool]

Found 12 relevant posts:
1. @jessepollak: "Base just hit 10M transactions..."
2. @0xDesigner: "The Base ecosystem is growing fast..."
...

PostToX

Draft and post replies. Franklin always shows you the draft and requires confirmation before posting:

plaintext

You: "Reply to that first tweet about Base"

Franklin: Here's my draft reply:

  "Incredible milestone! The growth in daily
   active addresses is even more impressive."

Post this reply? [y/n]

Confirmation required

Franklin will never post to social media without your explicit confirmation. Every post shows a preview and waits for approval.

Batch CLI

For automated social workflows, use the batch CLI commands:

bash

# Initial setup — configure browser profile
franklin social setup

# Log in to X (opens browser for auth)
franklin social login

# Configure topics and behavior
franklin social config

# Run a batch engagement cycle
franklin social run

# View engagement statistics
franklin social stats

Deduplication

Franklin tracks which posts it has already engaged with and automatically deduplicates. Running franklin social run multiple times will not reply to the same posts twice.

No X API key

Social tools use Playwright browser automation instead of the X API. This means no API key application, no rate limit tiers, and no developer account required. Just log in with your regular X account.