用途:该技能用于通过 Neynar API 与 Farcaster 去中心化社交协议交互,适用于读取 Farcaster 信息流、查询用户、发布 cast、搜索内容以及互动操作的场景。
核心概念:FID 是用户的永久数字标识;Cast 类似一条推文;Channel 是话题信息流;Frame 是可嵌入 cast 的交互式小程序。
主要能力:支持按用户名或 FID 查询单个或多个用户;读取用户信息流、频道信息流、热门信息流与关注流(关注流需 signer);搜索 cast 与用户,可按频道过滤;按 hash 或 URL 获取 cast;发布 cast、回复、在频道内发帖及带嵌入内容发帖;点赞、转发、关注与取消关注;读取通知(需 signer)。
使用方式:先在 dev.neynar.com 获取 API key,并创建配置文件 ~/.clawdbot/skills/neynar/config.json,填入 apiKey,发布类写操作还需 signerUuid;signer 可通过 Neynar 的 signer 管理创建,使用托管 signer 更简便。配置后可用 scripts/neynar.sh user dwr.eth 验证。常用命令示例:scripts/neynar.sh user --fid 5650;scripts/neynar.sh feed --channel base;scripts/neynar.sh feed --trending;scripts/neynar.sh search "ethereum";scripts/neynar.sh post "gm farcaster";scripts/neynar.sh like 0x1234abcd;scripts/neynar.sh follow dwr.eth。
限制:写操作(发帖、点赞、关注)必须配置 signer,否则返回 403;API key 无效返回 401;用户或 cast 不存在返回 404;请求过多返回 429。免费额度为每分钟 300 次请求,付费层级提供更高额度,可通过 X-RateLimit-Remaining 响应头查看。所有响应均为 JSON。
建议:缓存用户查询结果,优先使用频道发帖,批量请求时使用 bulk 端点,并针对速率限制实现退避重试。官方文档见 https://docs.neynar.com,开发者门户为 https://dev.neynar.com。