neynar-farcaster

Farcaster CLI for AI agents. Pure bash (curl + jq) — no Node.js required.

24 commands covering feeds, casts, search, engagement, notifications, channels, storage, and more.

Install

As OpenClaw/Moltbot skill

Copy the skill directory to your skills folder, or install via ClawHub.

Standalone

git clone https://github.com/arcabotai/neynar-farcaster.git
cd neynar-farcaster
chmod +x scripts/neynar.sh

Setup

1. Get an API key from dev.neynar.com
2. Create config:

mkdir -p ~/.clawdbot/skills/neynar
cat > ~/.clawdbot/skills/neynar/config.json << 'EOF'
{
  "apiKey": "YOUR_NEYNAR_API_KEY",
  "signerUuid": "YOUR_SIGNER_UUID",
  "fid": "YOUR_FID"
}
EOF

3. Verify: ./scripts/neynar.sh user dwr

Commands

Read (API key only)

• user <name|fid> — User profile (with neynar_score + power_badge)
• feed --user|--channel|--trending|--following — Feeds
• search "query" — Search casts
• search-users "query" — Search users
• cast <hash|url> — Cast details
• notifications — Your mentions, likes, follows
• conversation <hash> — Full thread view
• followers [user] — List followers
• following [user] — List following
• popular [user] — Most popular casts
• channel <id> — Channel info
• channels <query> — Search channels
• trending-channels — Trending channels
• storage — Storage allocation
• fname <name> — Check name availability

Write (requires signer)

• post "text" [--reply-to hash] [--channel id] [--embed url] — Post cast
• like <hash> / unlike <hash> — Like/unlike
• recast <hash> / unrecast <hash> — Recast/unrecast
• delete <hash> — Delete cast
• follow <user> / unfollow <user> — Follow/unfollow

Dependencies

• curl
• jq

Based on

Originally from BankrBot/openclaw-skills neynar skill, extended with 12 additional commands, improved output formatting, and notifications/channel/storage support.

License

MIT