clutch-agency-api

Clutch.co Agency API：B2B 企業データ、ディレクトリ、レビュー

エージェンシーやサービスプロバイダーの B2B ディレクトリである Clutch.co の企業データ API です。任意のカテゴリディレクトリを巡回し、企業プロフィール全体を取得して、検証済みクライアントレビューをすべてページネーションで取得できます。結果は JSON および LLM 対応の Markdown で返されます。このリポジトリでは、Python のクイックスタートと、Claude、Cursor、ChatGPT 向けの Model Context Protocol（MCP）インストール手順という 2 つの利用方法を紹介します。

Apify Store のアクター：Clutch.co Agency API

無料の Apify API キーを取得：https://apify.com?fpr=9n7kx3

テキストでの解説

これは Clutch.co の企業データ APIです。mode を選び、URL またはキーワードを指定すると、整形された行データが返されます。directory モードでは、https://clutch.co/web-developers のような Clutch のカテゴリページを渡すと、企業ごとに 1 行が返されます。各行には、企業名、評価、レビュー数、最小プロジェクト規模、時間単価、チーム規模、所在地、プロフィールリンクが含まれます。これにより、マーケティングエージェンシーのデータベースや、地域別のデジタルマーケティングエージェンシー一覧を作成できます。profiles モードでは、企業プロフィールの URL（またはスラッグのみ）を渡すと、説明、創業年、割合付きのサービス構成、業界、クライアント規模、価格帯、検証済みクライアントレビューの全件（それぞれ個別の行）を含む完全なレコードが返されます。すべてのプロフィールには、追加料金なしで Clutch 独自の LLM 対応 Markdown を付けることもできます。これにより、B2B サービスプロバイダーの候補を絞り込んだり、RAG パイプラインにデータを渡したりするのに適した情報源になります。search モードでは、キーワードを渡すと、一致する企業プロフィールが収集されます。

取得できるデータ

• ディレクトリ掲載情報（listing 行）：企業名、評価、レビュー数、認証バッジ、最小プロジェクト規模、時間単価、従業員数、所在地、プロフィール URL。
• 企業プロフィール（profile 行）：上記すべてに加え、説明、創業年、すべてのオフィス所在地、言語、サービス分野、重点領域、業界、クライアント規模の内訳、コスト評価、サービス別料金、パッケージ。
• クライアントレビュー（review 行）：タイトル、評価、品質・スケジュール・コスト・紹介意向の内訳、プロジェクトのサービス、予算、期間、レビュアーの役職と業界、Clutch 独自の要約。
• 任意のプロフィール行に含まれる Markdown（デフォルト）と、リクエストに応じて取得できる生の HTML。

クイックスタート（Python）

この例では、uv を使って Python を実行します。pip は使用しません。

1. uv をインストールします（まだインストールしていない場合）。

curl -LsSf https://astral.sh/uv/install.sh | sh

2. このリポジトリをクローンして、そのディレクトリに移動します。

git clone https://github.com/johnisanerd/Apify-Clutch-Agency-API.git
cd Apify-Clutch-Agency-API

3. Apify API トークンを追加します。.env.example を .env にコピーし、トークンを貼り付けます（https://apify.com?fpr=9n7kx3 で無料で取得できます）。

cp .env.example .env

4. 実行します。デフォルトの実行では、費用を抑えるため、ディレクトリページ 1 件、10 行を取得します。

uv run python clutch-agency-api-example.py

5. ほかのモードも試してみましょう。

uv run python clutch-agency-api-example.py --example directory
uv run python clutch-agency-api-example.py --example profiles
uv run python clutch-agency-api-example.py --example search

入力パラメーター

フィールド	型	説明
mode	string	directory（デフォルト）、profiles、または search。
directoryUrls	array	Clutch のカテゴリまたは所在地のページ。例：https://clutch.co/web-developers。
maxPagesPerDirectory	integer	ディレクトリ URL ごとの結果ページ数。各ページには約 70～90 社が掲載されています。
profileUrls	array	企業プロフィールの URL。例：https://clutch.co/profile/ignite-visibility。スラッグのみでも指定できます。
searchQueries	array	自由入力の検索語。例：shopify development。
includeReviews	boolean	検証済みレビューをすべて個別の行として返します。デフォルトは true。
maxReviewsPerProfile	integer	企業ごとのレビュー件数の上限。
outputFormats	array	json、markdown（デフォルト）、および任意で html。
maxItems	integer	実行時に返す行数の上限。支出上限として使用します。

出力例

{
  "result_type": "profile",
  "name": "Ignite Visibility",
  "profile_url": "https://clutch.co/profile/ignite-visibility",
  "website": "https://ignitevisibility.com",
  "rating": 4.8,
  "review_count": 175,
  "min_project_size": "$1,000+",
  "hourly_rate": "$100 - $149",
  "employees": "250 - 999",
  "founded_year": 2013,
  "headquarters": "San Diego, CA",
  "service_lines": [{ "name": "Search Engine Optimization", "percent": 30 }],
  "markdown": "# Ignite Visibility\n## Company Information\n..."
}

MCP ツールとしてインストールする

以下のセクションでは、Clutch.co Agency API を Model Context Protocol ツールとして Claude、Cursor、ChatGPT に追加し、アシスタントから直接呼び出せるようにします。MCP サーバーの URL はどの環境でも同じです。

https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api

https://apify.com?fpr=9n7kx3 で無料の Apify アカウントを作成し、 https://console.apify.com/settings/integrations でトークンを取得してください。

Claude Cowork Desktop にインストールする

Cowork はデスクトップアプリの自動化モードです。Clutch.co Agency API をツールとして利用できるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、Settings → Connectors に移動します（または Settings → Developer → Edit Config に移動し、claude_desktop_config.json を 直接編集します）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. この Actor のみをプリロードした Apify MCP サーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出すときは、ブラウザーで OAuth のプロンプトに応答するか、コネクターの設定に Apify API トークンを追加して OAuth を省略します。
4. Cowork のチャットで、Clutch.co Agency API を実行するよう依頼します。

デスクトップアプリをダウンロードして無料トライアルを開始する：https://claude.ai/referral/uIlpa7nPLg 詳しい説明：https://docs.apify.com/platform/integrations/claude-desktop

Claude Code にインストールする

Claude Code はコマンドラインツールです。次のコマンドで Actor の MCP サーバーを追加します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api"

ブラウザーの OAuth の代わりにトークンを使用するには、次のようにします。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp list で確認するか、セッション内で /mcp を実行します。Claude Code に Clutch.co Agency API を呼び出すよう依頼してください。

Claude Code を無料でお試しください：https://claude.ai/referral/uIlpa7nPLg Claude Code MCP のドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストールする

claude.ai では、Apify をコネクターとして追加し、この Actor のツールだけを有効にします。

1. Settings → Connectors → Browse connectors に移動し、 Apify MCP server を検索します。インストールします（プロンプトが表示された場合は、 有効化または更新します）。
2. 接続時に Apify API トークンで認証し、ツール johnvc/clutch-agency-api を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択し、プロンプトが表示されたら OAuth を使用して、 MCP の完全な URL https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api を貼り付けます。
5. Claude に Clutch.co Agency API を実行するよう依頼します。

ウェブで Claude を開く：https://claude.ai

Cursor にインストールする

Cursor はプロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api"
    }
  }
}

2. ブラウザーの OAuth ではなくトークン認証を使用する場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが 接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Cursor に Clutch.co Agency API を呼び出すよう依頼します。

Cursor を初めてお使いですか？こちらから入手できます：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT にインストールする

ChatGPT は開発者モードを通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education プランで利用できます）。

1. プロフィールアイコンをクリックし、設定 > アプリに移動します。アプリを作成ボタンが表示されない場合は、詳細設定を開き、開発者モードを有効にします。
2. アプリを作成をクリックし、フォームに入力します。
   • 名前： Apify
   • MCP サーバー URL： https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api
   • 認証： OAuth
3. 作成をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャットで**＋**をクリックし、開発者モードを選択して、Apifyを選びます。

詳しくは、https://docs.apify.com/platform/integrations/mcp をご覧ください。

🤖 このアクターについて AI アシスタントに質問する

お好きな AI で Clutch.co Agency API についてすぐに送信できるプロンプトを開きます。

• 💬 ChatGPT を開く
• 🧠 Claude を開く
• 🔍 Perplexity を開く
• 🅒 Copilot を開く

あわせて検索されている質問

これは企業データ API ですか？ はい。Clutch.co から、企業属性、サービス構成、価格帯、評価、認証済みレビューを含む構造化された企業レコードが返されます。CRM やベクトルストアにそのまま取り込める JSON 形式です。

B2B ディレクトリとして使えますか？ はい。ディレクトリモードでは、Clutch のカテゴリページまたは地域ページを読み取り、掲載企業ごとに 1 行を返します。そのまま使える B2B ディレクトリのエクスポートデータを取得できます。

マーケティングエージェンシーのデータベースを構築できますか？ はい。ディレクトリモードの対象をマーケティングカテゴリに設定して、結果をページごとに取得すると、評価、料金、所在地を含むマーケティングエージェンシーのデータベースを作成できます。

クライアントのレビューを取得できますか？ はい。プロフィールモードと検索モードでは、認証済みのクライアントレビューがそれぞれ個別の行として返され、企業が申告した合計件数に達するまでページごとに取得されます。

Clutch.co のアカウントや API キーは必要ですか？ いいえ。Clutch 側で設定するものはありません。アクターの実行に必要なのは Apify API トークンだけです。https://apify.com?fpr=9n7kx3 で無料で取得できます。

リンク

• Apify Store のアクター：https://apify.com/johnvc/clutch-agency-api?fpr=9n7kx3
• Apify Python クライアントのドキュメント：https://docs.apify.com/api/client/python/
• Apify MCP のドキュメント：https://docs.apify.com/platform/integrations/mcp

最終更新日：2026.10.27