subimpact data (Apify)

@subimpact/data-mcp

AI エージェント向けの公開データツールを、1 つの MCP サーバーにまとめました。お使いの Apify アカウントを接続すると、モデルは Google（オーガニック検索結果、「他の人はこちらも質問」、ナレッジグラフ、AI Overviews 全文）の検索、Google AI Mode クエリの実行、東南アジアのパブリッシャーを対象としたニュース掲載の追跡、Google マップの場所、Google Jobs、トレンド、ウェブサイトの連絡先、ページの Markdown 変換、Ads Transparency データ、YouTube、TikTok、Eventbrite、ATS の採用ページ、Substack、Bluesky、Lazada の商品、JSON-LD エンティティグラフ、SEO 監査、Pinterest の情報収集を、ブラウザーのタブではなく JSON で行えます。各ツールは subimpact Apify Store の 1 つのアクターをラップしています。サーバーはお客様の APIFY_TOKEN でアクターを起動して完了を待ち、データセットのアイテムを返します。スクレイピングはローカルでは行われず、当社の認証情報も使用しません。

インストール

Apify API トークンが必要です：console.apify.com → Settings → Integrations。実行料金は、各アクターの Store 価格（イベントごとの従量課金）で、その Apify アカウントに請求されます。

Claude Code

claude mcp add subimpact-data -e APIFY_TOKEN=... -- npx -y @subimpact/data-mcp

Claude Desktop

claude_desktop_config.json に追加します（macOS では ~/Library/Application Support/Claude/、Windows では %APPDATA%\Claude\）。

{
  "mcpServers": {
    "subimpact-data": {
      "command": "npx",
      "args": ["-y", "@subimpact/data-mcp"],
      "env": {
        "APIFY_TOKEN": "apify_api_your_token"
      }
    }
  }
}

Cursor

同じブロックを .cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加します。

{
  "mcpServers": {
    "subimpact-data": {
      "command": "npx",
      "args": ["-y", "@subimpact/data-mcp"],
      "env": {
        "APIFY_TOKEN": "apify_api_your_token"
      }
    }
  }
}

ツールのリストを絞り込みたい場合は、args に "--tools", "google_search,news_mentions" を追加するか、env に SUBIMPACT_TOOLS=google_search,news_mentions を設定します。get_run_results は常に利用できます。

ツール

ツール	機能	価格
google_search	JSON 形式の Google 検索：AI Overview の回答全体（リスト、引用、ソース）に加え、オーガニック検索結果、「他の人はこちらも質問」、ナレッジグラフ、トップニュース、ローカル検索結果をまとめて取得します…	Google SERP：$0.003
google_ai_mode	Android Chrome で表示される、本物の Google AI モードの回答（udm=50 タブ）を、あらゆる国と言語で取得します：回答全文、構造化ブロック、解決済みのソース URL、段落ごとの…	AI モード検索完了：$0.003 + プラットフォーム利用料
news_mentions	キーワードで厳選されたニュースフィードのインデックスを検索し、タイトル、抜粋、発行元 URL、ソース、地域、トピック、言語、公開時刻を含む整形済みの記事データを取得します…	記事：$0.001 + プラットフォーム利用料
google_maps_places	Google マップの場所情報を抽出します：タイトル、住所、座標、電話番号、ウェブサイト、評価、レビュー数、営業時間、混雑する時間帯、画像、価格帯、メニュー、場所 ID。次の条件で検索できます…	スクレイピングした場所：$0.001；スクレイピングしたレビュー：$0.0005；アクターの開始：$0.00005 + プラットフォーム利用料
google_jobs	クエリと国を指定して Google Jobs の求人情報をスクレイピングします：職種、会社、勤務地、掲載元（LinkedIn、Indeed など）、掲載日、給与、雇用形態、説明、応募リンク。…	求人：$0.001 + プラットフォーム利用料
website_contacts	任意のウェブサイトのリストから、メールアドレス、電話番号、ソーシャルプロフィールのリンク（Facebook、Instagram、LinkedIn、X、TikTok、YouTube、WhatsApp、Telegram）を抽出します。プレーン HTTP で、…	スキャンしたページ：$0.0008 + プラットフォーム利用料
google_trends	キーワードの Google Trends の時系列推移、関連クエリ／トピック、地域別の関心度をスクレイピングします。API キー、ブラウザー、CAPTCHA は不要です。最大 5 個のキーワードを比較できます…	キーワードトレンド一式：$0.0025 + プラットフォーム利用料
web_page_markdown	AI エージェントと RAG パイプライン向けのウェブ検索・取得ツールです。Google 検索にクエリを送信し、上位 N ページを生の HTTP 経由でスクレイピングして、整形済みの Markdown を返します。1 ページあたり $0.001 に加え…	抽出したページ：$0.001 + プラットフォーム利用料
google_ads_transparency	Google Ads Transparency Center をスクレイピングします：名前または ID で広告主を検索し、フォーマット、初回・最終表示日、プレビュー、広告リンクを含む広告をエクスポートします。条件で絞り込めます…	広告：$0.0008；広告主：$0.0005 + プラットフォーム利用料
youtube	ブラウザーも API キーも不要な、高速 YouTube スクレイパーです：フィルター付きキーワード検索、チャンネル動画と Shorts、チャンネルの概要データ、再生リスト、動画の詳細（正確ないいね数…）	結果：$0.001 + プラットフォーム利用料
tiktok_hashtag	高速 TikTok ハッシュタグスクレイパーです。非常に競争力のある価格で、ハッシュタグから動画、再生数、いいね数、コメント数、シェア数、音声の詳細、クリエイタープロフィールを抽出します。	動画：$0.001
eventbrite_events	Eventbrite のイベントを、会場と主催者のデータを標準で含めてスクレイピングします。1 イベントあたり $0.002。利用料は購入者が支払います。都市／クエリ／カテゴリ検索、URL モード、主催者モード、dryRun に対応します。	イベント：$0.002 + プラットフォーム利用料
company_career_jobs	企業の採用ページから最新の求人情報を直接取得します。Greenhouse、Lever、Ashby、Workday、SmartRecruiters に対応し、単一のスキーマに正規化します。新着求人のモニタリングにも対応…	スクレイピングした求人：$0.001；モニタリング対象の会社：$0.02 + プラットフォーム利用料
substack	Substack Intel API — 投稿、アーカイブ、パブリケーションの統計	実行開始：$0.00005；投稿またはパブリケーションの行：$0.001 + プラットフォーム利用料
bluesky	キーワード、ハッシュタグ、ハンドルで Bluesky の投稿、プロフィール、スレッド、フォロワーグラフをスクレイピングします。ログイン不要です。高速な AT Protocol API、JSON/CSV エクスポートに対応し、…ごとに課金されます	スクレイピングした投稿：$0.001；スクレイピングしたプロフィール：$0.002 + プラットフォーム利用料
lazada_products	Apify の住宅用プロキシを介した実ブラウザーセッションで、東南アジア 6 市場（MY/SG/TH/ID/PH/VN）の Lazada 検索結果とカテゴリページをスクレイピングします。価格下落をモニタリングし、…	スクレイピングした商品：$0.00099；確認した商品：$0.003；作成したアラート：$0.01 + プラットフォーム利用料
jsonld_entities	深くネストされた JSON-LD を抽出し、Schema.org（979 種類、1,633 プロパティ）に照らして検証したうえで、分離したブロックを型付きの統合ナレッジグラフに解決します…	アクターの開始：$0.00005；処理したページ：$0.0015 + プラットフォーム利用料
seo_page_audit	SEO Minion 拡張機能を API として移植したものです：URL ごとの包括的なページ内監査（メタタグ、見出し、画像、リンク、構造化データ、hreflang）に加え、Google SERP のスニペットプレビュー…	ページ監査：$0.001；SERP プレビュー：$0.001 + プラットフォーム利用料
pinterest	キーワード検索、ボード、プロフィールから Pinterest のピンをスクレイピングします。フル解像度のオリジナル画像、動画バリエーション、ボード／ピンナーのメタデータ、リピン数に対応します。純粋な HTTP で、ブラウザー不要、…	スクレイピングしたピン：$0.00199；ダウンロードしたメディア：$0.005 + プラットフォーム利用料
各ツールでは、次の2つの制御パラメーターも任意で指定できます。

• _maxItems（整数、デフォルトは50、最大1000）— モデルに返すデータセット項目数です。レスポンスのみを切り詰めます。アクターは、入力で指定された項目を引き続き収集します（その費用も発生します）。
• _maxChargeUsd（数値、デフォルトは0.5）— 1回の実行に対するUSDでの支出上限です。Apifyには実行オプションmaxTotalChargeUsdとして送信されます。上限に達すると実行が停止するため、誤って大規模なバッチを実行しても、費用がこの上限を超えることはありません。

追加のget_run_resultsツール（runId、_maxItems、offset）を使うと、ツール呼び出しの応答時点でまだ実行中だった実行のステータスと項目を取得できます。時間のかかるジョブは、いつまでも応答を待たせる代わりにrunIdを返すので、後からこのツールを呼び出して結果を取得してください。

費用の管理

呼び出しのたびに、お客様のアカウントで実際にApifyの実行が行われ、アクターごとにイベント単位で課金されます（例：google_searchはSERPごとに$0.003、news_mentionsは記事ごとに$0.001）。サブスクリプションはなく、このサーバーがお客様に課金することもありません。Apifyからお客様のアカウントに直接請求されます。

• デフォルトの_maxChargeUsdである$0.50から始めてください。Apifyに渡され、プラットフォームによって適用されます。
• _maxItemsを使って、モデル側のコンテキスト（およびトークン使用量）を抑えてください。
• 結果をさらに絞り込みたい場合は、上限を引き上げるのではなく、アクターへの入力を絞り込んでください。
• 各レスポンスにはitemCount（データセット内の項目総数）とreturned（モデルに送信された項目数）が含まれるため、結果が切り詰められたかどうかを確認できます。

1回のツール呼び出しで待機する時間は、最大SUBIMPACT_TIMEOUT_SECS秒（デフォルトは240秒）です。実行がまだ続いている場合はrunIdが返され、get_run_resultsで結果を取得できます。

設定

変数	必須	説明
APIFY_TOKEN	はい（呼び出し時）	Apify APIトークンです。ディレクトリがサーバーを調べられるように、tools/listはこれがなくても動作します。
SUBIMPACT_TOOLS	いいえ	公開するツール名をカンマ区切りで指定したサブセットです。例：google_search,news_mentions。
SUBIMPACT_TIMEOUT_SECS	いいえ	1回の呼び出しで待機する時間（秒）の上限です（デフォルトは240）。
SUBIMPACT_API_BASE	いいえ	Apify APIのベースURLを上書きします（デフォルトはhttps://api.apify.com/v2）。モックを使ったテストを想定しています。

CLIフラグ：--tools a,b,c、--help、--version。

これは何ではないか

• ローカルスクレイパーではありません。 ページを取得したり、HTMLを自ら解析したりすることはありません。Apifyのインフラ上でスクレイピングを行うApifyアクターを実行します。
• 当社が保有する認証情報を使うものではありません。 使用するトークンは、お客様が設定したAPIFY_TOKENのみです。このサーバーにシークレットは含まれておらず、非公開のバックエンドへの呼び出しも行いません。
• 無料ではありません。 ツールを呼び出すたびにApifyが実行され、アクターのStore価格に基づいてお客様のApifyアカウントに請求されます。_maxChargeUsdの上限は1回の実行に適用されるものであり、Apifyの月間利用額に対する上限ではありません。
• 公式のApify製品ではなく、 アクターが公開データを読み取るGoogle、TikTok、Meta、Lazadaなどのプラットフォームとも提携していません。
• データを保証するものではありません。 公開サイトの内容は変化します。現在の対応範囲、料金、制限事項については、各アクターのStoreページをご確認ください。

開発

npm install
npm run build       # tsc + copy src/tools.json into dist/
npm test            # offline tests: mocked fetch + a stdio round trip
npm run typecheck
npm run gen:readme  # regenerate the tool table above from src/tools.json
node dist/index.js  # run the stdio server

src/tools.jsonは、公開されているApify Storeのアクターメタデータ（ツール名、説明、イベントごとの料金、入力スキーマ）の完全なスナップショットです。MCPツールの定義と説明、およびこのREADMEのツール表は、ここから生成されます。

ライセンス

MIT © 2026 subimpact network