Gemleadを、CRMにもスタックにもAIにも。

Xのリード獲得APIを使えば、Xで見つかった買い手を自社のツールで受け取り、そのまま次の行動につなげられます。誰かが手作業でリストをエクスポートする必要はありません。GemleadのAPIでは、エージェントがXで見つけてスコアリングしたリードを、スコアとその理由つきで取得でき、その背後にあるペルソナ、キャンペーン、会話、DMも扱えます。署名付きのWebhookは、リードがホットになった瞬間や返信したときにあなたのサーバーを呼び出し、MCPサーバーを使えば、Claude、ChatGPT、Cursorが普段の言葉でGemleadを操作します。3つともBusinessプランに含まれ、ひとつのキーで使えます。

ポイントはスピードです。誰かがCRMにコピーするまでタブの中で待っているホットリードは、どんどん冷めていきます。以下では、その遅れがもたらすコスト、それぞれの機能、そして実際のリクエストを紹介します。

Xのリードを自社のスタックに届けるべき理由

別のツールに置かれたままのリードは、対応が遅れるか、まったく手がつけられません。

• 分断されたツールはすべてを遅くする。 営業担当者4 050人を対象にしたSalesforceのState of Sales 2026によると、AIを導入している営業リーダーの半数以上、51%が、システムの分断によってAIの取り組みが遅れていると答え、営業担当者の74%がデータクレンジングに力を入れています。
• データのコピーが販売の時間を奪う。 同じレポートによると、営業担当者が販売に使っている時間は平均40%です。Z世代の営業担当者では35%にとどまり、手作業のデータ入力に週およそ丸2時間を奪われています。
• ホットリードはすぐ冷める。 125万件のリードを対象にしたHarvard Business Reviewの研究では、1時間以内にリードへの連絡を試みた企業は、それより遅かった企業に比べ、リードの見極めに成功する可能性が約7倍高くなりました。
• リサーチはAIへ移りつつある。 Gartnerの予測では、2027年までに営業担当者のリサーチ業務の95%がAIから始まるようになります。2024年には20%未満でした。

Xのリード獲得API、MCPサーバー、Webhookでできること

REST API

すべてのエンドポイントはhttps://gemlead.ai/api/v1の下にあり、JSONでやりとりします。GemleadのメニューでAPIを開き、Xアカウントを選び、キーに名前をつけてスコープを選びます。スコープはreadのみ、またはreadとwriteです。キーはgl_live_で始まり、表示されるのは一度だけで、そのXアカウントのデータにしかアクセスできません。

対応している範囲は次のとおりです。

• リード：hot、score_min、ペルソナ、日付などのフィルターで一覧を取得し、リードの獲得元を確認し、再スコアリングやフォローを行い、CRMのIDなど独自のmetadataを保存できます。
• ペルソナとソース：ペルソナの作成、ソースの追加、設定の変更、ほかのXアカウントとの共有。
• キャンペーン：テンプレートからの下書き作成、開始と一時停止、日ごとの統計と推移の取得。
• 会話：スレッドの閲覧、テキスト、画像、GIF、動画、ボイスメモでのDM送信、リアクション、パイプライン内での会話の移動。
• エクスポートと分析：リードのCSVまたはJSON Lines形式のエクスポートと、ダッシュボードのグラフ。
• Julien AI：自社のコードから、GemleadのAIアシスタントにアカウントについて質問。

最新のホットリードを取得する例です。

curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=10

各リードは、Xのプロフィール、0から100のscore、1文で書かれたscore_reason、ペルソナ、ステータスとともに返されます。キーごとに1分あたり120リクエストまでです。APIから送るDMは、Xアカウントごとに1分10件、1日300件が上限で、Xがそれより低い上限を設定している場合はそちらに従います。

Webhook

アプリのAPIで公開HTTPSのURLを登録するか、POST /v1/webhook_endpointsを使い、受け取るイベントを選びます。

各リクエストにはGemlead-Signatureヘッダーが付きます。HMAC SHA256の署名で、エンドポイントのシークレットを使って検証します。配信に失敗すると、約45時間かけて7回再試行されます。エンドポイントはアカウントごとに最大10個まで登録でき、特定のペルソナのリードだけに絞ることもできます。Webhookガイドでは、Node.jsとPythonでの検証方法を紹介しています。

MCPサーバー

Model Context Protocolは、AIアプリケーションを外部のシステムにつなぐためのオープンソースの標準です。https://gemlead.ai/mcpにあるGemleadのサーバーは、Claude、ChatGPT、Cursor、Claude Codeに60を超えるツールを提供します。search_leads、get_campaign_stats、list_conversations、send_message、create_exportなど、APIでできることごとにひとつずつです。ClaudeとChatGPTはOAuthでサインインするので、キーをコピーする必要はありません。Claude Codeなら、コマンドひとつで設定できます。

claude mcp add --transport http gemlead https://gemlead.ai/mcp \
  --header "Authorization: Bearer $GEMLEAD_API_KEY"

あとは「Tipstersペルソナの今日のホットリードを、スコアが高い理由つきで見せて」と聞くだけです。書き込み系のツールにはwriteスコープが必要で、アシスタントは何かを送信、開始、削除する前に、必ずあなたに確認します。複数のXアカウントで使うには、アカウントごとに接続を追加します。設定手順の全体はドキュメントにあります。

成果につながる理由

• ポーリングよりプッシュ。 リードがホットになった瞬間にWebhookがサーバーに届くので、確認のためにリクエストを使わなくても、CRMや営業担当者は最初の1時間のうちにそのリードを受け取れます。
• リード1件にレコード1件。 CRMのIDをリードのmetadataに保存すれば、その後のイベントはすべて同じレコードに紐づきます。重複が減り、整理の手間も減ります。
• AIアシスタントはすでにMCPに対応している。 Anthropicの報告によると、稼働中の公開MCPサーバーは10 000を超え、SDKの月間ダウンロード数は9700万回以上です。MCPはChatGPT、Cursor、Gemini、Microsoft Copilot、Visual Studio Codeに採用されています。Gartnerは、2028年までにB2B営業担当者の業務の60%が対話型AIのインターフェースを通じて行われると予測しています。
• エージェントには良いデータが必要。 Gartnerの予測では、2028年の時点で、AIエージェントによって生産性が上がったと答える営業担当者は40%に満たないとされています。生のリストではなく、スコアごとに理由がついたスコアリング済みのリードをエージェントに渡すことが、成果を実感する側に入る方法です。

手作業のエクスポートとGemlead APIの比較

APIはこんな方に

• 開発者とRevOps担当者で、自社のコードや、Webhookを受け取れる自動化ツールを使って、XのリードをHubSpot、Salesforce、Pipedrive、Attio、Notion、Google スプレッドシートに同期したい方。
• ClaudeやChatGPTで仕事をする創業者で、ホットリードと返信を同じチャットで確認したい方。
• 代理店で、クライアントのXアカウントごとにキーを1つずつ用意し、分析のエンドポイントからクライアントに報告したい場合。
• 独自のAIエージェントを開発するチームで、スクレイパーの代わりに、Gemleadのスコアリング済みリードとDMツールをエージェントに渡したい場合。
• B2Cの販売者、たとえばスポーツベッティングの予想家や有料コミュニティを運営するクリエイターで、ホットリードをチームのツールで受け取りたい方。

それらのリードがどう見つかるかは、Xでリードを見つける方法で解説しています。エージェントにメッセージを書かせる前に、AI SDRにできること、できないことも読んでおきましょう。

ベストプラクティス

1. ツールごとにキーを1つ。 GEMLEAD_API_KEYのような環境変数に入れて、サーバー上で管理します。writeは、データを変更するツールにだけ与えましょう。
2. Webhookはすべて検証する。 生のボディで署名を確認し、5分より古いタイムスタンプは拒否します。
3. すぐに応答し、処理はあとで。 10秒以内に2xxを返し、イベントはキューで処理します。配信は少なくとも1回行われるので、処理済みのイベントidはスキップしましょう。
4. 大量のデータはエクスポートで。 1回のエクスポートは、何百ページもの取得に勝ります。
5. 許可する前に読む。 アシスタントは、読み込んだテキストにだまされることがあります。書き込み系のツールを承認する前に、何をしようとしているかを確認しましょう。

よくある質問