farcaster

Farcaster

Interact with the Farcaster decentralized social protocol via Neynar API.

Setup

Get your API key from dev.neynar.com:

export NEYNAR_API_KEY=xxx

# Optional: For posting (requires signer)
export NEYNAR_SIGNER_UUID=xxx

Commands

Users

/​fc user <username>           Look up user profile
/​fc search-users <query>      Search for users

Feeds

/​fc feed [--channel X]        Get feed (optionally from channel)
/​fc trending                  Trending casts
/​fc channel <id>              Get channel info
/​fc channels <query>          Search channels

Search

/​fc search <query>            Search casts

Write Operations (require signer)

/​fc post <text>               Post a cast
/​fc reply <hash> <text>       Reply to a cast
/​fc like <hash>               Like a cast
/​fc recast <hash>             Recast
/​fc follow <username>         Follow user
/​fc unfollow <username>       Unfollow user

Examples

/​fc user vitalik.eth
/​fc trending
/​fc channel base
/​fc search "ethereum"
/​fc post "Hello Farcaster!"
/​fc follow dwr.eth

Rate Limits

• Free tier: 300 requests/​minute
• Standard: 1,000 requests/​minute
• Premium: Higher limits

Features

• User profiles with verified addresses
• Cast search and feeds
• Channel discovery
• Trending content
• Full write operations (with signer)