核心用法
Farcaster Skill 是一套基于 Neynar v2 REST API 的 Bash 脚本工具集,专为需要去中心化社交自动化场景设计。无需任何 npm 依赖,仅依赖系统标配的 curl 与 jq,即可实现完整的 Farcaster 社交操作:
内容发布与互动:通过 fc_cast.sh 可发布文本、图片/视频嵌入、频道帖子、回复及引用串;fc_react.sh 支持点赞、取消赞、转发、取消转发;fc_delete.sh 可删除已发布内容。
信息获取与搜索:fc_feed.sh 读取用户动态、频道流、关注流及帖子回复串;fc_user.sh 支持通过用户名、FID 或以太坊地址查询用户资料;fc_search.sh 提供全文搜索能力,支持作者过滤和频道限定;fc_channels.sh 可搜索频道、获取详情及热门榜单。
典型场景:多帖串联发布(Thread)、@提及监控轮询、先上传媒体再嵌入发布的工作流。
显著优点
1. 零依赖轻量化:纯 Bash + curl + jq,无需 Node.js 生态,部署成本极低
2. 功能覆盖全面:涵盖 Farcaster 核心社交场景(发帖、互动、搜索、频道管理)
3. 自动化友好:标准 JSON 输出,易于与 CI/CD、定时任务、Agent 系统集成
4. 灵活认证:支持环境变量或命令行参数传入 API Key 和 Signer UUID
潜在缺点与局限性
- 付费墙限制:频道搜索、全文搜索、删帖、频道详情等核心功能需 Neynar 付费计划(402 错误)
- 速率限制严格:免费版 300 请求/分钟,高频监控场景需升级或增加延迟
- 无官方 SLA:依赖 Neynar 服务可用性,非 Farcaster 官方直接 API
- 媒体处理间接:图片视频需先上传至第三方托管(如 catbox),再获取 URL 嵌入
适合人群
- Web3 开发者与社区运营者需自动化 Farcaster 账号
- 链上数据分析团队需监控特定关键词或账号动态
- AI Agent 项目需集成去中心化社交能力
- 偏好轻量化脚本而非重型 SDK 的技术用户
常规风险
- API 密钥泄露风险:
NEYNAR_API_KEY与NEYNAR_SIGNER_UUID需妥善保管,泄露可导致账号被恶意操作 - Signer 权限风险:Signer UUID 对应链上签名权限,需确认授权范围
- 内容合规风险:自动化发帖需遵守 Farcaster 社区规范,避免垃圾信息导致账号封禁
- 付费意外:脚本未显式拦截付费端点,误调用可能产生账单
- 第三方依赖:Neynar 服务变更或定价调整可能影响功能可用性