Pod Researcher

@pipeworx/pod-researcher

ゲスト出演やスポンサー獲得のためのポッドキャスト候補探しに使えます。トピックと目的を指定すると、最近のエピソードでそのトピックを扱っている活動中のポッドキャストを返します。各番組について、番組自身が公開した最適な連絡手段、適合性を裏付けるエピソード、過去のアプローチ履歴も確認できるため、同じ番組に二度売り込みをすることを防げます。

Pipeworx の一部です。AI エージェントを1684以上の稼働中のデータソースにつなぐ MCP ゲートウェイです。

ツール

• find_podcast_contacts(topic, purpose, require_route?, language?, country?, active_only?, include_engaged?, limit?, cursor?) — トピックとの適合度が高い順に活動中の番組を返します。各番組について、best_route（または確認した内容を示す route_status: "none_found"）、根拠となるエピソード、対象件数、data_as_of を含みます。purpose は guest または sponsor です。その目的専用に指定された連絡先が優先され、一般的な問い合わせ先または個人が公開しているアドレスは代替候補として表示されます。require_route: true を指定すると、連絡先が見つかった番組のみが返されます。
• get_podcast_profile(id) — 番組1つの詳細情報を返します。識別情報、活動状況、フィードの状態、最新エピソード、公開済みの連絡先をすべて確認できます。id には show_id、RSS フィード URL（移転したフィードは以前の URL から解決されます）、または podcast:guid を指定します。
• refresh_podcast(id) — 次回の定期確認を待たずに、番組1つの RSS フィードを再読み込みします。
• watch_podcast_topic(topic, purpose, ...) / get_podcast_topic_changes(watch_id?) — 検索を保存し、新たに条件に一致した番組を取得します。
• record_podcast_outreach(show_id, outcome, scope?, contact_id?) — contacted / replied / declined / booked / bounced / do_not_contact / clear を記録します。辞退または do_not_contact と記録された番組は検索結果から除外されます。scope: "person" を指定すると、その人物のアドレスを公開している番組がすべて非表示になります。記録はアカウント内でのみ利用できます。

認証

検索はキーなしで利用できます。watch_podcast_topic、get_podcast_topic_changes、record_podcast_outreach の利用にはサインイン済みアカウント（pipeworx.io/signup で取得した API キー）が必要です。アプローチ履歴はアカウントごとに保存され、匿名ユーザーには履歴がありません。このパックは Pipeworx ゲートウェイ上でのみ動作します。単独のビルドでは空のリストを返すのではなく、すべての呼び出しを拒否します。

連絡先：返される情報とラベルの付け方

番組が自身の RSS フィードまたはウェブサイトで公開しているアドレスはすべて、次のラベルとともに返されます。

• holder_type：role（booking@ や sponsorships@ のような機能別の受信用アドレス）、hosting_account_owner（フィードの itunes:owner アドレス。通常はホストのアドレス）、または person（個人のアドレス）。
• purpose（guest、sponsor、general）と confidence（その目的への問い合わせを番組が明示的に案内している場合は designated、それ以外は fallback）。最適な連絡先には match（designated_for_purpose または general_fallback）も含まれます。
• source_url（情報を読み取ったページまたはフィード）と last_observed。

アドレスを生成することはありません。全体の削除リストは提供時に適用されます。record_podcast_outreach ではアドレスを受け取りません。メールアドレスの形式を含む呼び出しは、そのアドレスを再表示せずに拒否され、人物単位の記録にはアドレス自体ではなく SHA-256 が保存されます。

データソース

• Podcast Index のオープンディレクトリ（https://podcastindex.org）— 存在するポッドキャスト、そのフィード URL、識別子を確認します。
• 各番組の RSS フィード — エピソード、配信頻度、itunes:owner アドレス、エピソードのノートに記載された出演募集文。
• 各番組の公式ウェブサイト — ゲスト出演、広告、問い合わせの各ページ。

マッチングはエピソードのタイトルと番組ノート内の単語を対象とします（番組ごとに最新の約30エピソード）。そのため、ノートにトピックを一度も記載していない番組は見つかりません。AI の利用をエピソードノートで開示している実際の番組も一部検出する分類器によって、生成コンテンツのスパムは除外されます。連絡先情報の収集範囲は拡大中です。各結果の route_check で番組のウェブサイトをすでに確認したかどうかが分かるため、「連絡先が見つからなかった」と「まだ確認していない」を区別できます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "pod-researcher": {
      "url": "https://gateway.pipeworx.io/pod-researcher/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/pod-researcher/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx の共有メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック独自のツールとともに、共有ツールが約 30 個表示されます。接続の initialize レスポンスに正確な対象範囲が記載されており、その日の対象範囲を確認する際の信頼できる情報源です。

これは意図的なもので、意図せず多重化されているわけではありません。メタツールを使うことで、このパックでは扱えない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を介して回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL でも同じゲートウェイに接続でき、同じ 1684 以上のデータソースを利用できます。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/find_podcast_contacts \
  -H 'Content-Type: application/json' \
  -d '{"topic":"AI agents developer infrastructure","purpose":"guest","limit":5}'

最初の呼び出しにはアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/find_podcast_contacts を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も必要ありません。

{
  "mcpServers": {
    "pod-researcher": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-pod-researcher"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-pod-researcher

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に対して、このパックのツールのみを返します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Pod Researcher data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT