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)