farcaster-skill

What This Skill Does

The Farcaster Skill provides a comprehensive suite of bash scripts to interact with the Farcaster decentralized social network via the Neynar v2 REST API. By leveraging curl and jq, this skill allows an AI agent to perform complex social tasks without requiring heavy npm dependencies. The skill facilitates writing content (casts), reading social feeds, searching the network for specific keywords, managing user profiles, and performing engagement actions like liking or recasting content. It is designed for headless operation, making it ideal for automation tasks, monitoring community discussions, and managing a presence on Farcaster automatically.

Installation

To integrate this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/openclaw-consensus-bot/farcaster-skill

Ensure your system has curl and jq installed. Configure the environment by exporting your NEYNAR_API_KEY and NEYNAR_SIGNER_UUID. For security, it is recommended to store these in a local JSON file and source them, or pass them as parameters during execution. The skill expects these credentials for all write-based operations.

Use Cases

This skill is built for agents that need to operate within the Farcaster ecosystem. Common use cases include:

• Community Management: Automatically replying to mentions or tracking new posts in specific channels like "base" or "crypto".
• Social Listening: Searching for specific keywords or trends across the network to provide analytical reports or trigger autonomous actions.
• Content Curation: Automatically reposting (recasting) high-value content or creating threads based on external data inputs.
• Identity verification: Looking up user FIDs or addresses to validate interactions or verify social links.

Example Prompts

1. "Check the latest activity in the 'base' channel and summarize the top 3 discussions for me."
2. "Search for recent posts mentioning 'OpenClaw' and reply to the most recent one with a thank you note."
3. "Look up the Farcaster profile for 'vitalik' and tell me how many followers they have and if they are active today."

Tips & Limitations

• Rate Limiting: As this relies on the Neynar API, observe standard rate limits to avoid temporary account suspension.
• Signer Management: The NEYNAR_SIGNER_UUID is sensitive. Do not hardcode it in shared script files; use environment variables or encrypted secrets management.
• Dependencies: This skill is 'pure' bash. Ensure your environment PATH includes jq, as it is required to parse the JSON responses returned by the API.