mcpField
X
x-research

x-research

github.com/crawlora-orgマーケティング・グロース141 回インストール2 日前に更新
リポジトリ

x-research について

x-research は Crawlora API を使い、X の公開プロフィール、最近の投稿、個別投稿の詳細を取得するスキルです。ソーシャルリスニングやアカウント調査向けで、ブラウザー自動化や公式 X API を使わず、正規化された JSON を返します。

主な機能

  1. 01公開プロフィールと表示データの取得
  2. 02プロフィールページの最近の投稿取得
  3. 03投稿本文とエンゲージメント指標の取得
  4. 04ユーザー名による投稿者確認

活用シーン

  1. 01アカウントの自己紹介とフォロワー数の確認
  2. 02アカウントの最近の投稿状況の把握
  3. 03指定投稿の本文と指標の調査
  4. 04競合やインフルエンサーの公開アカウント監視

インストール

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

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill x-research

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

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

X（Twitter）リサーチ

Crawlora API から正規化された JSON として、公開 X プロフィール、最近の投稿、個別投稿の内容とエンゲージメントを取得します。ブラウザーの自動操作や公式 X API へのアクセスは不要です。

このスキルを使う場面

  • 「X で のプロフィール／フォロワー数を教えてください」
  • 「X で の最近の投稿を取得してください」
  • 「この X の投稿には何と書かれていて、エンゲージメントはどれくらいですか？」
  • X API にアクセスせずに、X で競合他社やインフルエンサーのソーシャルリスニングを行う場合。

セットアップ（初回のみ）

  • https://crawlora.net で Crawlora API キーを無料で取得します（月 2,000 クレジット、カード不要）。
  • ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
  • ヘルパーは環境から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

  1. プロフィール — GET /x/profile/{username} は、X のユーザー名に対応する公開プロフィールの詳細を返します。表示されている各種件数や、利用可能な場合はプロフィールのメディアも含まれます。
  2. プロフィールの投稿 — GET /x/profile/{username}/posts は、公開プロフィールの最初のページのペイロードに含まれる投稿を返します（デフォルトは 20 件、limit で最大 50 件）。返信、メディアのみのタブ、検索結果のページネーションには対応していません。
  3. 投稿の詳細 — GET /x/post/{id} は、数値の投稿 ID で指定した公開投稿を 1 件返します。投稿者、テキスト、表示されている指標、引用投稿がある場合はそのプレビューも含まれます。投稿者が一致することを必須にするには username を渡します（一致しない場合は 404 が返されます）。

エンドポイント、メソッド、パラメーターの一覧については、reference/endpoints.md を参照してください。

API の呼び出し

# Profile:
scripts/crawlora.sh /x/profile/nasa | jq '.'

# Profile posts (capped at 50 per page):
scripts/crawlora.sh /x/profile/nasa/posts limit=30 | jq '.'

# Single post, with author check:
scripts/crawlora.sh /x/post/1234567890 username=nasa | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルが使用するすべての X エンドポイントについては、reference/endpoints.md を参照してください。

使用例

  • プロフィールのスナップショット： /x/profile/<handle> を使って、アカウントを追跡する価値があるか判断する前に、フォロワー数、フォロー数、自己紹介を確認します。
  • 最近のアクティビティの確認： /x/profile/<handle>/posts を使って、返信やメディアタブをたどらずに、投稿頻度やトピックを確認します。
  • 単一投稿の検索： /x/post/<id> を使って、他の場所で共有されたリンクなどから特定の投稿のテキストと指標を取得します。必要に応じて username= で投稿者を検証できます。

注意事項と制限

  • クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
  • 公開データのみ — 公開プロフィールと投稿のみが対象です。ログインや非公開コンテンツには対応していません。X の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコードしたり、クエリパラメーターに含めたり、コミットしたりしないでください。
  • X の検索やトレンドには非対応 — このスキルの対象はプロフィール、プロフィールの投稿、投稿の詳細のみです。/x/search やトレンドのエンドポイントはありません。
  • プロフィールの投稿は単一ページで、カーソルによるページネーションには非対応 — /x/profile/{username}/posts が返すのは最初のページのペイロードに含まれる内容のみです（limit は 1～50、デフォルトは 20）。タイムラインをさかのぼって取得することはありません。
  • 投稿の検索には数値 ID のみを使用 — /x/post/{id} には投稿の数値 ID が必要です。ツイート URL のスラッグやユーザー名は使用できません。ID の衝突や不一致を防ぐには username を渡してください。

コメント

Markdown 対応