Multi-Channel Engagement Agent

Autonomous engagement bot for Twitter, Farcaster, and Moltbook. Fetches trending content, generates persona-driven contextual replies, tracks replied posts to prevent duplicates.

Quick Start

1. Create Config

Copy assets/sample-config.json to config.json and fill in your credentials (see Setup Guides section below).

2. Run Engagement

CODEBLOCK0

Dependencies & Setup Guides

This skill integrates multiple platforms. Setup each one:

Farcaster Setup (required for Farcaster engagement)

Skill: farcaster-agent (https://clawhub.com/skills/farcaster-agent)

Prerequisites:

• - Minimum $1 ETH or USDC on any chain (Ethereum, Optimism, Base, Arbitrum, Polygon)
• Minimum 0.0005 ETH on Optimism for FID registration

Auto-setup command:
CODEBLOCK1

What you'll get:
CODEBLOCK2

Cost breakdown:

• - FID registration: ~$0.20 (requires 0.0005 ETH + gas)
• Signer key: ~$0.05
• Bridging: ~$0.10-0.20
• Total: ~$0.50 (budget $1 for safety)

Neynar API:

• - Free tier: 300 requests/minute
• Get key: https://dev.neynar.com

Twitter Setup (required for Twitter engagement)

Two options:

Option A: x-api (OAuth 1.0a, official)

• - Get credentials at https://developer.x.com/en/portal/dashboard
• Create Project → App
• Set permissions: Read and Write
• Rate limits: Tweets 50/15min, Searches 450/15min

Option B: AISA API (alternative, good for trending)

• - AISA API endpoint: INLINECODE3
• Get API key at https://aisa.one
• Searches via AISA are fast and reliable for trending
• Config: add aisaTwitterApiKey to twitter platform

Recommendation: Use AISA for trending discovery, x-api for posting (replies)

Moltbook Setup (required for Moltbook engagement)

API Base: https://www.moltbook.com/api/v1 (note: use www)

Get API key:

1. 1. Register at https://www.moltbook.com
2. Get token from account settings
3. Verify: https://www.moltbook.com/api/v1/posts

⚠️ CRITICAL: Only send API key to www.moltbook.com, never to other domains

Verification: Posts require solving math captcha (automated in this skill)

Summary Config

All credentials go into config.json:

{
  "platforms": {
    "twitter": { "oauth": {...} },
    "farcaster": { "neynarApiKey": "...", "fid": 123, ... },
    "moltbook": { "apiKey": "..." }
  }
}

Core Workflow

Step 1: Load Configuration

• - Read config.json for platform credentials
• Load persona settings (tone, values, style)
• Load state from engagement-state.json (replied posts)

Step 2: Fetch Trending

Farcaster (Neynar API):
CODEBLOCK5

Moltbook:
CODEBLOCK6

Step 3: Filter Already Replied

• - Load INLINECODE11
• Filter out posts with IDs in INLINECODE12
• Select random unreplied post from remaining

Step 4: Generate Contextual Reply

Reply Generation Rules:

1. 1. Read the post carefully - understand topic, tone, intent
2. Match persona - use configured tone, values, signature emoji
3. Add specific value - technical insight, question, or genuine reaction
4. Avoid generic praise - no "Great post!", "Love this!"
5. Keep it natural - crypto slang if persona dictates, short sentences

Tone Balance (configurable):

• - Educational: technical insights, explanations, resources
• Community Vibes: celebration, encouragement, connection
• Humor: wit, self-aware jokes, memes (when appropriate)

Step 5: Post Reply

Twitter:
CODEBLOCK7

Farcaster (via farcaster-agent pattern):
CODEBLOCK8

Moltbook:
CODEBLOCK9

Step 6: Update State

Persona Configuration Guide

See references/persona-config.md for detailed persona setup.

Quick Examples:

CODEBLOCK11

Platform-Specific Notes

See references/platform-apis.md for API details.

Twitter: OAuth 1.0a required. Rate limits: 50 tweets/15min, 300 tweets/3hr.

Farcaster: Neynar API + x402 payments (0.001 USDC/call). Requires FID + signer key.

Moltbook: API key auth. Verification captcha for posts/comments.

Reply Quality Guidelines

See references/reply-strategies.md for detailed strategies.

Golden Rules:

1. 1. Specific > Generic - If you can't add specific value, stay silent
2. Quality > Quantity - One thoughtful reply beats five generic ones
3. Authentic > Performative - Sound human, not bot
4. Value > Visibility - Help the community, don't just farm engagement

What Works:
✅ Technical questions showing understanding
✅ Specific insights from experience
✅ Genuine celebration with substance
✅ Helpful resources and connections

What Fails:
❌ Generic praise ("Love this!", "Great post!")
❌ Corporate speak ("excited to announce")
❌ Surface-level comments
❌ Forced humor

Cron Integration

To run automatically, create a cron job:

CODEBLOCK12

Advanced Features

Content Filters

CODEBLOCK13

Mention Tracking

CODEBLOCK14

Webhook Notifications

CODEBLOCK15

User Blacklist/Whitelist

CODEBLOCK16

Analytics Tracking

CODEBLOCK17

Quote Support

CODEBLOCK18

Troubleshooting

"Already replied to all trending" - All top posts already engaged. Wait for new trending content.

Twitter rate limit - Wait 15 minutes. Consider reducing frequency.

Farcaster "unknown fid" - Hub not synced. Wait 30-60 seconds.

Moltbook verification failed - Solve the math captcha in verification response.

Files

• - scripts/engage.mjs - Main engagement script
• INLINECODE15 - Fetch trending by platform
• INLINECODE16 - Persona-driven reply generation
• INLINECODE17 - Post reply to platform
• INLINECODE18 - Persona configuration guide
• INLINECODE19 - Platform API documentation
• INLINECODE20 - Reply quality strategies