HeyLead: LinkedIn Outreach & Lead Generation MCP Server

HeyLead

HeyLead は LinkedIn のアウトリーチを行う AI エージェントです。適切な相手を見つけ、あなた自身の LinkedIn 投稿の文体でメッセージを作成し、フォローアップを行い、返信にも対応します。Claude Code、Cursor、任意の MCP クライアント、またはウェブダッシュボードから利用できます。ウェブでサインインしてから、AI に「リードを探して」と話しかけてください。

ユースケース

キャンペーンの目標は 6 種類あり、ICP、適合性の確認、メッセージはその目標に沿って決まります。製品やサービスの販売、仕事探し、人材採用、パートナーや投資家探し、ベンダー探し、インタビュー調査です。

• 製品やサービスの販売：あなたが作ったものを購入する人にアプローチします。
• 仕事探し：希望する職種の採用担当者にアプローチします。
• 人材採用：募集する職種の候補者にアプローチします。カスタムブリーフに対応しています。
• パートナーや投資家探し：パートナーシップや投資を決定できる人にアプローチします。カスタムブリーフに対応しています。
• ベンダー探し：あなたが購入者です。必要なものを販売する人にアプローチします。
• インタビュー調査：インタビュー、アンケート、テストの対象となる人にアプローチします。カスタムブリーフに対応しています。

人材採用、パートナーや投資家探し、インタビュー調査では、メッセージセットが作成されるまでカスタムブリーフに基づいて進行します。

---

はじめに

MCP（Model Context Protocol）を使うと、AI アシスタントが外部ツールを利用できます。HeyLead を使えば、AI があなたに代わって LinkedIn のアウトリーチを行えます。

必要なもの： Cursor または Claude Code — MCP 対応の AI エディターであれば利用できます。

ステップ 1：HeyLead をインストールする

Claude Code、プラグインとして利用する場合（ホスト型、インストール不要）：

/plugin marketplace add D4umak/linkedin-outreach-mcp
/plugin install heylead@heylead

次に /mcp を実行し、heylead を選んで「Authenticate」を選択し、HeyLead アカウントにサインインします。このプラグインはホスト型サーバー https://heylead.dev/mcp に接続し、キャンペーンの開始、保留中のメッセージの承認、返信への回答、週次レビュー、一時停止、人物リストの追加を行うスキルを追加します。ソースは plugins/heylead にあります。

または、stdio 経由でクライアントをローカル実行します。 uv が必要です。

Claude Code：

claude mcp add heylead -- uvx heylead

Cursor： Settings > MCP > 「Add new MCP server」> Name: heylead、Command: uvx heylead

任意の MCP クライアント：

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

uvx --refresh heylead で更新してください。

ステップ 2：アカウントをセットアップする

オプション A — ホスト型（最も簡単）： 90 秒のクイズに回答するか、heylead.dev/dashboard/login からサインインします。クイズで設定したペルソナが、キャンペーンの下書きになります。「Settings」→「Connected accounts」で LinkedIn を接続し、ダッシュボードから開始するか、「Settings」→「Integrations」→「Chat client」からセットアップメッセージをコピーして、AI とのチャットに貼り付けます。開始するまでメッセージが送信されることはありません。ホスト型ユーザーはプロフェッショナルディレクトリを共有しますが、キャンペーンと受信トレイは非公開です。

オプション B — セルフホスト： すべてを自分のアカウントで実行します。まず、次の 2 つが必要です。

1. Unipile アカウント — LinkedIn との通信に使用します。unipile.com でサインアップし、「Access Tokens」ページにある DSN と API キーを設定してから、heylead config set unipile_api_url <DSN> と heylead secrets set unipile_api_key を実行します（入力を求められます。キーは OS のキーチェーンに保存され、設定ファイルには保存されません）。
2. LLM API キー — AI の呼び出し料金はあなたに請求されます。開始するには、無料の Gemini キーで十分です。

次に、AI チャットを開いて、次のように話しかけます。

「この Gemini キーを使って HeyLead プロフィールをセットアップしてください：YOUR_KEY」

LinkedIn 認証リンクが表示されます。リンクを開いて LinkedIn に接続し、「finish setup」 と入力します。HeyLead がプロフィールを取得し、文章のスタイルを分析します。

ステップ 3：リードを探す

"Find me CTOs at fintech startups in New York"
"Send outreach to the campaign"
"Check my replies"
"How's my outreach doing?"

---

仕組み

1. ICP を定義する — 「AI SaaS の創業者向けの ICP を生成して」→ 課題、障壁、LinkedIn でのターゲティングを含む、RAG を活用したペルソナを生成します
2. キャンペーンを作成する — 「フィンテック企業の CTO を探して」→ LinkedIn を検索し、適合度に応じて見込み客をスコアリングします
3. 見込み客との関係を温める — アプローチする前に、投稿へのコメントや「いいね」で交流します
4. パーソナライズした招待を送信する — ボットではなく、あなたらしく聞こえる、あなたの声に合わせたメッセージを送ります
5. 自動でフォローアップする — つながりが承認された後、複数回にわたるシーケンスでフォローアップします
6. 返信に対応する — 感情を検出し、前向きな見込み客をミーティングへ進め、質問に回答します
7. 結果を追跡する — 成約／失注／配信停止の追跡と、コンバージョン分析を行います

送信モデル： キャンペーンは下書きとして作成され、明示的に開始した場合にのみ動き出します。すべての送信は、送信前にレート制限、営業時間の確認、1次つながりの確認を通過します。HeyLead は、人間のペースであなた自身の LinkedIn アカウントから送信します。無料の LinkedIn アカウントでは、招待は1日最大20件、週最大100件です（Premium または Sales Navigator では上限が増えます。新たに接続された有料アカウントは1日20件から始まり、上限に達するまで毎週倍増します）。送信時間は、あなたのタイムゾーンで月曜日から金曜日の08:00～22:00で、送信間隔は数分です。LinkedIn から制限を受けると送信ペースを落とし、自動で再開します。いつでもキャンペーンを一時停止できます。開始操作によってクラウド送信も有効になります。observe モードでは、どちらのマシンからも有効化も送信も行われません。

承認モード（ホステッド）： 別の設定を選択していないワークスペースでは、冒頭の DM とフォローアップはすべて、担当者が承認するまで保留され、承認されたテキストが送信されます。ダッシュボードの「承認」ページ、または inspect(action="waiting") で保留中のメッセージを確認し、prospect(action="approve_message") または discard_message で決定します。オートパイロットでは未読のまま送信され、切り替えは1か所で行えます（「設定」→「送信」、または scheduler(action="approval_mode", mode="autopilot")）。招待、InMail、返信は保留されません。

---

ツール

HeyLead は AI に22個のツールを提供します。

中核となるワークフロー

ツール	機能
setup_profile	LinkedIn に接続し、あなたの文体を分析して声のシグネチャを作成します
generate_icp	購買者のペルソナを含む、詳細な理想顧客プロファイルを生成します
icp	保存済みの ICP に合致する LinkedIn プロフィールをプレビューします。キャンペーンは作成しません
profile_signals	ターゲティングのリクエスト（国とのつながり、関心事）を LinkedIn の検索クエリとプロフィールの根拠に基づくスコアリングに変換します
create_campaign	自然言語の説明から、アウトリーチキャンペーンを下書きとして作成します
generate_and_send	パーソナライズした LinkedIn メッセージを生成して送信します
check_replies	キャンペーン全体の新着返信を確認し、感情を分類して、有望な見込み客を表示します
book_meeting	合意した通話を Google Calendar に登録し、見込み客に招待を送信します
show_status	ダッシュボードです。キャンペーン、統計、有望な見込み客、アカウントの健全性を確認できます。一致する heylead.dev/dashboard ページへのリンクと、ホステッドアカウントではスナップショットカードも添付します

アウトリーチとエンゲージメント

ツール	機能
send_message	見込み客にフォローアップや返信を送信します
send_email	接続済みの Unipile メールボックス（Gmail／Outlook）からメールを送信します。Mail.app は使用しません
engage_prospect	見込み客の投稿にコメントしたり、リアクションしたり、フォローしたり、推薦したりして、信頼を築きます
inbox	LinkedIn の受信トレイのメッセージを直接閲覧、確認します
backfill_inbox	未返信の受信トレイメッセージをインバウンドパイプラインで処理します
create_post	あなたの声に合わせた投稿を生成して LinkedIn に公開するか、写真または短い動画を添えて、あなたが承認した文章を公開します

キャンペーン管理

ツール	機能
campaign	キャンペーンのライフサイクル管理 — 開始、一時停止、再開、アーカイブ、削除、緊急停止、失敗した処理の再試行
edit_campaign	キャンペーン名、モード、予約リンク、コンテキスト項目を編集します
prospect	見込み客を管理します — スキップ、結果を付けてクローズ、会話やタイムラインの表示
import_prospects	CSV データから見込み客をキャンペーンにインポートします

インサイトと分析

ツール	機能
analytics	キャンペーン分析 — レポート、比較、エクスポート
inspect	オペレーターによる保留、ストラテジストによる再計画、クロージャーの判断、返信のスキップ、実行制限されたジョブの読み取り専用ダイジェスト
knowledge	メッセージの根拠となるナレッジベースを管理します — ソースの一覧表示、追加、削除、更新、検索。ホスト型のみ
suggest_next_action	影響度の高い順に優先順位を付けて、最適な次のアクションを推奨します
signals	購買シグナルを表示・分析します — ニュース、企業へのエンゲージメント、ウェブサイト訪問、プロフィール閲覧者
manage_watchlist	シグナルのキーワードウォッチリストを追加、削除、一覧表示します
network	ネットワークインテリジェンス — メンバーが接続したアカウントを共有する相互プール。利用するには参加が必要です

成長と関係構築

ツール	機能
brand_strategy	LinkedIn の個人ブランドを分析し、改善します
profile	LinkedIn プロフィールの変更履歴を表示・復元します
partner	ビジネスパートナー、ベンダー、投資家へのフォローアップを追跡します
contacts	グローバルな連絡先データベースを検索、閲覧、管理します
crm_sync	キャンペーンの連絡先と取引を HubSpot CRM と同期します

自動化とアカウント

ツール	機能
scheduler	自律型スケジューラーを管理します — ステータス、オン／オフ、send_from（クラウドがデフォルト／ローカルはオプトイン）
product	ローカルの git チェックアウトのみ — このリポジトリにパッチを適用する、または PR を作成する
account	LinkedIn アカウントを管理します — 一覧表示、切り替え、接続解除
organization	ホスト型組織 — 一覧表示、切り替え、編集者／閲覧者の招待、クライアントワークスペースの作成

---

主な機能

音声スタイルの再現 — LinkedIn のプロフィールと投稿を分析して、文章のスタイルを把握します。すべてのメッセージが、あなた自身が書いたような仕上がりになります。

ICP の生成 — RAG を活用したパイプラインが企業のコンテキストをクロールし、課題、懸念、障壁を含むバイヤーペルソナを作成して、LinkedIn の検索パラメーターに対応付けます。

自律型スケジューラー — バックグラウンドで動作し、稼働時間とレート制限を守ります。ホスト型アカウントでは、すべてのキャンペーンでクラウドがデフォルトの送信元です。開始するとクラウドに処理が委任されるため、送信可能時間内であれば、ノート PC を閉じていてもアウトリーチが続きます。対象は、招待、最初の DM、最初の InMail、フォローアップ、エンゲージメント、フォロー、推薦、メールでの代替連絡、見込み客の補充、自動返信、インバウンド、ウォームアップ、シグナル収集、投稿インテリジェンスです。このマシンでは、それらの処理のためにローカルのスケジューラーエンジンは起動しません。scheduler(action='send_from', host='local') でアカウント全体をこのマシンに移すと、クラウドスケジューラーがオフになります。「監視」の場合は、送信は行われません。直接インストール／セルフホスト型インストールでは、このマシンからのみ送信します。

エンゲージメントによるウォームアップ — 接続リクエストを送る前に、見込み客の投稿に自動的にエンゲージメントして、親近感を築きます。

送信ペース — HeyLead は、あなた自身の LinkedIn アカウントから人間らしいペースで送信します。無料の LinkedIn アカウントでは、1 日あたり最大 20 件、週あたり最大 100 件の招待を送信します（Premium または Sales Navigator では上限が増えます。新たに接続した有料アカウントは、1 日 20 件から始まり、上限に達するまで毎週倍増します）。送信時間は、あなたのタイムゾーンで月曜日から金曜日の 08:00 から 22:00 までで、各送信の間には数分空けます。LinkedIn に制限された場合は送信ペースを落とし、自動的に再開します。キャンペーンはいつでも一時停止できます。

成果の追跡 — 取引を成約／失注として記録し、コンバージョン率を追跡し、停滞しているリードを特定し、エンゲージメントの ROI を測定します。

---

料金

プラン	料金	利用できる内容
Free	$0	見込み顧客あたり最大2回のフォローアップ
Pro	接続アカウント1つあたり月額$29	見込み顧客あたり最大5回のフォローアップ

接続アカウントとは、LinkedInのアカウントまたはメールボックスです。Freeでは、どちらか一方を1つ利用できます。

招待数の上限はHeyLeadのプランではなく、LinkedInアカウント（無料、Premium、またはSales Navigator）に準じます。 セルフホスト版の無料インストールには、月ごとの上限があります：招待50件、メッセージ20件、エンゲージメント30件、アクティブなキャンペーン1件、ICP生成3件。

---

プライバシー

• AIへのリクエスト — HeyLeadのバックエンド経由、または独自のキー経由で送信されます
• クラウドMCP — データはサーバー側で処理されますが、第三者と共有されることはありません
• ローカルモード — 連絡先とメッセージは、ローカルのSQLiteデータベースに保存され、端末の外に出ることはありません
• ツール呼び出しのテレメトリ — サインイン中は、HeyLeadのワークスペースに各ツール呼び出しが記録されます：ツール、成功したかどうか、エラーの種類、所要時間、呼び出したアプリ（Claude、ChatGPT、Cursor…）。引数、結果、見込み顧客の名前、リンク、メッセージは記録されません。heylead config telemetry off または DO_NOT_TRACK=1 で無効にできます

パワーユーザー向け： セットアップ時に独自のLLMキー（Gemini/Claude/OpenAI）を渡すと、独自のAIを利用できます。完全に任意です。

---

シークレットの保存場所

HeyLeadは、バックエンドトークン、Unipileキー、LLMキーをOSの認証情報ストア（macOS Keychain、Windows Credential Manager、Linux Secret Service）に保存します。認証情報ストアがない場合は、HeyLeadフォルダー内の所有者のみがアクセスできる secrets.json に保存します。設定ファイルには通常の設定のみが含まれます。シークレットを表示せずにインストール状態を確認するには、次のコマンドを使用します：

• heylead config get backend_url は通常の設定を1つ表示します
• heylead api get /api/v1/campaigns は、認証情報をマスクした状態で、ホストされたAPIを認証付きで読み取ります
• heylead secrets status は、保存されているシークレットの種類を一覧表示します。値は表示されません
• heylead secrets clean は、古い設定ファイルからシークレットを移動し、クラウドへの送信を行うインストールで使用しないキーを削除し、古い設定のバックアップコピーを削除します

バックエンドモードと環境変数

MCPクライアントがHeyLeadバックエンド（例：heylead-api）と通信する場合、バックエンドは次の環境変数を使用します。独自のバックエンドを運用する場合は、必要に応じて設定してください。

用途	環境変数の例
LLM	GEMINI_API_KEY、または他のプロバイダーを使用する場合は OPENAI_API_KEY / ANTHROPIC_API_KEY
検索 / クロール	ICPと企業情報の取得用の SERPER_API_KEY、FIRECRAWL_API_KEY（または同様の変数）
認証 / ストレージ	GOOGLE_*（OAuth）、UNIPILE_*（LinkedInプロバイダー）、および使用する場合はDB/Redis
オプション	機能フラグ、レート制限、ロギング — バックエンドリポジトリを参照してください

バックエンドの設定とデプロイの詳細は、heylead-api（またはバックエンド）リポジトリとそのドキュメントを参照してください。

---

オプションの依存関係

基本インストールでコア機能をすべて利用できます。高度なICP生成を利用する場合：

pip install heylead[icp]    # Embeddings for RAG-powered ICP generation
pip install heylead[crawl]  # Web crawling for company context ingestion
pip install heylead[all]    # Both

---

トラブルシューティング

「uvx: command not found」 まず uv をインストールしてください：curl -LsSf https://astral.sh/uv/install.sh | sh（Macでは brew install uv も使用できます）

「MCP サーバーが接続されない」 MCPサーバーの追加後にエディターを再起動してください。Cursorでは、Settings > MCPを開いて、サーバーに緑色の点が表示されていることを確認してください。

「セットアップに失敗しました」または「LinkedInが接続されていません」 サインインページのLinkedIn行（ダッシュボード：Settings → Connected accounts）で「Connect」をクリックし、LinkedInへのログインを完了したことを確認してください。その後、セットアップをもう一度実行してください。

お困りですか？ issueを作成してください。

---

PyPIへの公開（メンテナー向け）

HeyLeadをPyPIで利用できるようにする（または新しいバージョンを公開する）には：

オプション A：GitHub リリース経由で公開する（推奨）

1. 初回のみ： PyPI アカウントとAPI トークンを作成します。リポジトリで、Settings → Secrets and variables → Actions に移動し、トークンの値を使ってシークレット PYPI_TOKEN を追加します。
2. pyproject.toml のバージョンを更新します（version = "0.2.4"）。
3. コミットしてプッシュし、GitHub リリースを作成します（タグは v0.2.4 など。リリースタイトルは任意です）。ワークフロー .github/workflows/publish.yml がリリース時に実行され、PyPI に公開します。

オプション B：手動で公開する

pip install build twine
python -m build          # creates dist/
twine check dist/*       # optional: validate
twine upload dist/*      # prompts for PyPI username + password (use __token__ and your API token)

公開後は、誰でも claude mcp add heylead -- uvx heylead で追加できます（Cursor の場合：コマンド uvx heylead）。

---

AI エージェント向け

HeyLead は MCP ネイティブのツールとして設計されています。ボタンをクリックする人間ではなく、AI エージェント向けに構築されています。

MCP サーバーとしてインストール（stdio）：

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

OpenClaw： 同じエントリを openclaw.json の mcp.servers に追加します。 ClawHub でも利用できます。「HeyLead」で検索してください。

heylead.dev でサインインするか（ホステッド）、自身の Unipile アカウントと LLM API キーを使用します（セルフホスト）。

機能： LinkedIn のリード獲得、コールドアウトリーチの自動化、バイヤーペルソナを使った ICP の生成、文体を合わせたパーソナライズメッセージ、複数タッチのドリップシーケンス、返信の感情分類、エンゲージメントのウォームアップ、キャンペーン分析、ノート PC を閉じたままクラウドから行うスケジュール送信。

見込み客の発見から返信への対応までを行う22 個のツールを備えています。見込み客の発見、バイヤーペルソナを使った ICP の生成、メモ付きのつながりリクエスト、最初のメッセージとフォローアップ、ウォームアップ（プロフィールの閲覧、フォロー、コメント）、曖昧な内容を保留して確認を求める返信対応、成果の追跡が含まれます。

エージェント統合ガイドの全文は AGENTS.md を参照してください。

---

リンク

• PyPI
• MCP Registry
• Smithery
• ClawHub（OpenClaw スキルストア）
• Issues

ライセンス

MIT（コード）— LICENSE を参照してください。

ナレッジベースとプロンプトの設定はプロプライエタリです。