mcpField
N
neynar

neynar

github.com/bankrbotその他1.2k215 回インストール5 日前に更新
リポジトリ

neynar について

neynar は、Neynar API を通じて Farcaster を操作するコマンドラインスキルです。フィードの閲覧や検索に加え、signer が必要な投稿、リアクション、フォローにも対応します。

主な機能

  1. 01Farcaster ユーザーの検索
  2. 02ユーザー・チャンネル・トレンドのフィード閲覧
  3. 03キャストとユーザーの検索
  4. 04キャストや返信の投稿
  5. 05リアクションとユーザーのフォロー

活用シーン

  1. 01Farcaster チャンネルの動向確認
  2. 02キーワードによるユーザーやキャストの検索
  3. 03キャストの投稿や返信
  4. 04いいねやリキャスト、フォローの管理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bankrbot/skills --skill neynar

インストール後、Claude Code で/neynarを入力して読み込まれたか確認します。

同梱ファイルcatalog.jsonscripts/neynar.sh

詳細

Neynar（Farcaster API）

Neynar の API を通じて、分散型ソーシャルプロトコルである Farcaster を利用します。

クイックスタート

セットアップ
  1. dev.neynar.com から API キーを取得します
  2. 設定を作成します：
mkdir -p ~/.clawdbot/skills/neynar
cat > ~/.clawdbot/skills/neynar/config.json << 'EOF'
{
  "apiKey": "YOUR_NEYNAR_API_KEY",
  "signerUuid": "YOUR_SIGNER_UUID"
}
EOF

注：signerUuid は cast を投稿する場合にのみ必要です。Neynar の署名者管理から取得してください。

セットアップの確認
scripts/neynar.sh user dwr.eth

基本概念

  • FID — Farcaster ID。各ユーザーに割り当てられる永続的な数値識別子です
  • Cast — Farcaster への投稿（ツイートのようなもの）です
  • Channel — トピック別のフィード（subreddit のようなもの）です
  • Frame — cast に埋め込まれたインタラクティブなミニアプリです

使い方

ユーザーの検索
# By username
scripts/neynar.sh user vitalik.eth

# By FID
scripts/neynar.sh user --fid 5650

# Multiple users
scripts/neynar.sh users dwr.eth,v,jessepollak
フィードの読み込み
# User's casts
scripts/neynar.sh feed --user dwr.eth

# Channel feed
scripts/neynar.sh feed --channel base

# Trending feed
scripts/neynar.sh feed --trending

# Following feed (requires signer)
scripts/neynar.sh feed --following
検索
# Search casts
scripts/neynar.sh search "ethereum"

# Search users
scripts/neynar.sh search-users "vitalik"

# Search in channel
scripts/neynar.sh search "onchain summer" --channel base
Cast の取得
# By hash
scripts/neynar.sh cast 0x1234abcd...

# By URL
scripts/neynar.sh cast "https://warpcast.com/dwr.eth/0x1234"
Cast の投稿（署名者が必要）
# Simple cast
scripts/neynar.sh post "gm farcaster"

# Reply to cast
scripts/neynar.sh post "great point!" --reply-to 0x1234abcd

# Cast in channel
scripts/neynar.sh post "hello base" --channel base

# Cast with embed
scripts/neynar.sh post "check this out" --embed "https://example.com"
リアクション
# Like a cast
scripts/neynar.sh like 0x1234abcd

# Recast
scripts/neynar.sh recast 0x1234abcd
フォロー／フォロー解除
scripts/neynar.sh follow dwr.eth
scripts/neynar.sh unfollow dwr.eth

API リファレンス

使用するエンドポイント
操作エンドポイント認証
ユーザーの検索GET /v2/farcaster/user/by_usernameAPI キー
FID によるユーザー検索GET /v2/farcaster/user/bulkAPI キー
ユーザーフィードGET /v2/farcaster/feed/user/castsAPI キー
チャンネルフィードGET /v2/farcaster/feed/channelsAPI キー
トレンドGET /v2/farcaster/feed/trendingAPI キー
Cast の検索GET /v2/farcaster/cast/searchAPI キー
Cast の取得GET /v2/farcaster/castAPI キー
Cast の投稿POST /v2/farcaster/castAPI キー + 署名者
リアクションPOST /v2/farcaster/reactionAPI キー + 署名者
フォローPOST /v2/farcaster/user/followAPI キー + 署名者
レスポンス形式

すべてのレスポンスは JSON です。スクリプトは読みやすいよう、主要なフィールドを抽出します。

{
  "user": {
    "fid": 3,
    "username": "dwr.eth",
    "display_name": "Dan Romero",
    "follower_count": 450000,
    "following_count": 2800,
    "verified_addresses": ["0x..."]
  }
}

よくあるパターン

チャンネルを監視する
# Get latest casts from /base channel
scripts/neynar.sh feed --channel base --limit 20
アクティブなユーザーを見つける
# Search for users by keyword
scripts/neynar.sh search-users "ethereum developer"
Twitter からクロスポストする
# Post same content to Farcaster
scripts/neynar.sh post "gm, just shipped a new feature 🚀"
メンションに返信する
# Get your notifications (requires signer)
scripts/neynar.sh notifications

# Reply to specific cast
scripts/neynar.sh post "thanks!" --reply-to 0xabc123

エラー処理

エラー原因解決方法
401 UnauthorizedAPI キーが無効ですconfig.json を確認してください
403 Forbidden署名者が必要です書き込み操作用の署名者を設定してください
404 Not Foundユーザー／cast が存在しませんユーザー名／ハッシュを確認してください
429 Rate Limitedリクエストが多すぎます待ってから再試行してください

署名者の設定

書き込み操作（投稿、いいね、フォロー）には署名者が必要です：

  1. dev.neynar.com にアクセスします
  2. 新しい署名者を作成するか、マネージド署名者を使用します
  3. signerUuid を設定に追加します

マネージド署名者が最も簡単です。Neynar が鍵の管理を担います。

レート制限

  • 無料プラン：毎分 300 リクエスト
  • 有料プラン：より高い上限を利用できます
  • X-RateLimit-Remaining ヘッダーを確認してください

ベストプラクティス

  1. ユーザー検索結果をキャッシュする — FID は変わらず、ユーザー名が変わることもほとんどありません
  2. チャンネルを利用する — 無作為に投稿するよりも多くのユーザーに届きます
  3. 誠実に交流する — Farcaster では誠実さが大切にされています
  4. リクエストをまとめる — 可能な場合は一括エンドポイントを使用します
  5. レート制限に対処する — バックオフを実装します

リソース

トラブルシューティング

API キーが機能しない
# Verify key works
curl -H "x-api-key: YOUR_KEY" \
  "https://api.neynar.com/v2/farcaster/user/bulk?fids=1"
署名者の問題
  • 署名者が承認済みで有効になっていることを確認してください
  • 署名者の権限がご利用の FID と一致していることを確認してください
  • マネージド署名者はセルフホストよりも簡単です
Cast が表示されない
  • Cast は数秒で伝播しますが、インデックスへの登録にはさらに時間がかかる場合があります
  • レスポンス内の cast ハッシュを確認してください
  • warpcast.com で直接確認してください

コメント

Markdown 対応