cloro MCPサーバー
コミット 2026年11月7日国や州レベルのジオターゲティングを使用して、AI回答エンジンやGoogle検索、Googleニュースの結果をスクレイピングします。
別名 cloro-dev/mcp-server, mcp-server
- スター
- 0
- ツール
- 9
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.5.0
- 最終コミット
- 2026年11月7日
- ライセンス
- MIT
cloro MCPとは
国や州レベルのジオターゲティングを使用して、AI回答エンジンやGoogle検索、Googleニュースの結果をスクレイピングします。 9個のツールを提供しており、scrape_chatgpt, scrape_gemini, scrape_google_ai_modeなどがあります。
プロジェクトのREADMEから生成された概要
cloro MCP server について
cloroは、MCPクライアントを使用する開発者が、国や州レベルのジオターゲティングを用いてAI回答エンジンやGoogle検索、Googleニュースの結果をスクレイピングすることを可能にします。このMCP serverは、標準的なGoogleのウェブ検索やニュース結果に加え、ChatGPT、Gemini、Google AI Mode、Google AI Overview、Bing AI Modeからのデータへのアクセスをエージェントに提供します。Claude、Cursor、Codexでの使用を想定して設計されており、異なるAIの回答を比較したり、特定の地理的領域を調査したりする方法を提供します。
ユーザーは、ClaudeではOAuthを、その他のクライアントではAPIキーを使用して、mcp.cloro.dev のホストエンドポイント経由で接続できます。また、stdioを介してローカルで実行することも可能です。リアルタイム情報を取得するために、scrape_chatgpt、scrape_google、scrape_google_newsといった特化したツールを提供します。精密な調査のために、特定の国や米国の州をターゲットにすることができ、Googleのリダイレクトリンクを最終的な遷移先に解決するユーティリティも含まれています。
できること
- 1AIエンジンの回答比較エージェントに対し、Googleのトップ結果とChatGPTが提供する特定の回答を比較するよう指示できます。
- 2ジオターゲティング調査の実行特定の国や米国の州によってフィルタリングされた検索結果やAIの結果を取得できます。
- 3検索リダイレクトの解決リダイレクトリンクを使用しているGoogle検索結果の、実際の遷移先URLを特定できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
cloro MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude Codeにcloro MCPをインストール
$ claude mcp add --transport http mcp-server https://mcp.cloro.dev/mcpCursorにcloro MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.cloro.dev/mcp"
}
}
}VS Codeにcloro MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.cloro.dev/mcp"
}
}
}VS Code CLIにcloro MCPをインストール
$ code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.cloro.dev/mcp"}'Codexにcloro MCPをインストール
$ codex mcp add mcp-server --url https://mcp.cloro.dev/mcpCodex config.tomlにcloro MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp-server] url = "https://mcp.cloro.dev/mcp"
Gemini CLIにcloro MCPをインストール
$ gemini mcp add -s user --transport http mcp-server https://mcp.cloro.dev/mcpGemini settings.jsonにcloro MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.cloro.dev/mcp",
"type": "http"
}
}
}cloro MCPツール 9
READMEから検出scrape_chatgptscrape_geminiscrape_google_ai_modescrape_bing_aimodescrape_googlescrape_google_newsresolve_google_redirectlist_countrieslist_states
| scrape_chatgpt | — | |
| scrape_gemini | — | |
| scrape_google_ai_mode | — | |
| scrape_bing_aimode | — | |
| scrape_google | — | |
| scrape_google_news | — | |
| resolve_google_redirect | — | |
| list_countries | — | |
| list_states | — |
設定
MCP_TRANSPORT
| 名前 | 説明 | 種類 |
|---|---|---|
| MCP_TRANSPORT | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能cloro-dev/mcp-server is public and reachablegithub.com/cloro-dev/mcp-server ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-07github.com/cloro-dev/mcp-server ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない9 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 740 ms合格
README
GitHubで見るcloro MCP Server
A Model Context Protocol (MCP) server for cloro, the LLM scraping API that includes a Google SERP API. It gives Claude, Codex, Cursor and any MCP client answers from ChatGPT, Gemini, Google AI Mode, Google AI Overview and Bing AI Mode, plus Google web search and Google News results. Ask your agent "compare Google's top results for best LLM scraping API with ChatGPT's answer" and it calls cloro and reasons over the parsed results and cited sources.
Runs hosted at mcp.cloro.dev, or locally over stdio.
How do you connect an agent to the cloro MCP server?
In Claude, you sign in with OAuth and do not need a key:
- Go to Customize → Connectors and select Add custom connector.
- Enter
https://mcp.cloro.dev/mcp. Under Authentication, choose Sign in when needed. - Ask Claude to use a cloro tool. Sign in to cloro and select the organization whose credits pay for the calls.
Other clients use a cloro API key from the dashboard. The hosted server speaks Streamable HTTP. Put the key in the URL path so it works in clients that cannot set custom headers:
{
"mcpServers": {
"cloro": {
"type": "http",
"url": "https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp"
}
}
}
If your client can set headers, use https://mcp.cloro.dev/mcp with Authorization: Bearer YOUR_CLORO_API_KEY. In Claude Code:
claude mcp add --transport http cloro https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp
In Cursor
This repo is also a Cursor plugin. Install it from the Cursor marketplace, or point Cursor at the repo, and Cursor prompts for one variable:
| Variable | Value |
|---|---|
CLORO_API_KEY |
Your key from the dashboard |
Cursor stores the key on its side and sends it as Authorization: Bearer, so the key stays out of the URL and out of the repo. The manifest is .cursor-plugin/plugin.json and the server definition is mcp.json.
Running it yourself
npm install
npm run build
MCP_TRANSPORT=stdio CLORO_API_KEY=your_key node dist/index.js
MCP_TRANSPORT is http (default) or stdio. In stdio mode the client spawns the process and the key comes from CLORO_API_KEY; in http mode keys arrive per request and no key is configured on the server. PORT defaults to 8095 and CLORO_API_URL to https://api.cloro.dev.
OAuth is off unless you set CLERK_ISSUER. The hosted server sets it to https://clerk.cloro.dev. api.cloro.dev accepts only tokens from that issuer, so a self-hosted server that forwards to it must use the same value. MCP_PUBLIC_URL (default https://mcp.cloro.dev) sets the resource URL in the protected resource metadata.
What tools does it expose?
| Tool | Endpoint |
|---|---|
scrape_chatgpt |
POST /v1/monitor/chatgpt |
scrape_gemini |
POST /v1/monitor/gemini |
scrape_google_ai_mode |
POST /v1/monitor/aimode |
scrape_bing_aimode |
POST /v1/monitor/bing/aimode |
scrape_google |
POST /v1/monitor/google |
scrape_google_news |
POST /v1/monitor/google/news |
resolve_google_redirect |
POST /v1/monitor/google/goto |
list_countries |
GET /v1/countries |
list_states |
GET /v1/states |
The assistant tools take a prompt and a country (ISO 3166-1 alpha-2), plus an optional state for US state-level targeting. The Google tools take gl for the result geography and an optional hl for the interface language; country still works as a deprecated alias for gl. scrape_google_ai_mode targets sub-country with location or uule rather than state. scrape_google runs either from a query plus gl, or from a complete google.com/search URL that carries the query and pagination itself, and accepts include.aioverview for Google's AI Overview. Every tool takes an optional include object for heavier payload fields; leave it unset for the leanest response.
A Google result link can come back empty, or as a google.com/goto URL, with a redirectLink beside it. Pass the redirectLink to resolve_google_redirect to get the destination.
There is no Grok tool. Grok is discontinued: grok.com shows a sign-up wall to logged-out visitors, and the cloro API rejects Grok calls with a 400 (MODEL_UNAVAILABLE).
There are no Copilot or Perplexity tools. Both are discontinued: they block access for logged-out sessions, and the cloro API rejects their calls with a 400 (MODEL_UNAVAILABLE). These calls cost no credits.
How it works
The server holds no business logic and no secrets. Each request forwards the caller's own credential, an API key or an OAuth access token, to api.cloro.dev as a Bearer token, so authentication, credit billing, rate limiting and concurrency are all enforced by the API rather than here. In http mode every POST builds a fresh server and transport bound to that caller's credential, which is why one deployment serves everyone with no session state.
initialize and tools/list answer without a credential, so a client can list the tools before sign-in. The first tools/call without one returns 401 with a WWW-Authenticate header that points at /.well-known/oauth-protected-resource/mcp. An OAuth client reads the authorization server from there and runs the flow. The server checks a token's signature against the issuer's public JWKS (code in src/oauth-tokens/), so it needs no Clerk secret.
Tool input schemas are the same zod schemas the API validates with, vendored into src/schemas/ from cloro's backend. They are copied rather than imported because that package is not published. The API reference is authoritative if the two ever disagree.
FAQ
Do I need to self-host this?
No. mcp.cloro.dev is hosted and is the path most people should take. This repo exists so you can read what runs, and self-host if your setup calls for it.
Does it cost credits?
Yes. The scrape tools call the sync API, so each call costs the API rate plus a 2-credit sync surcharge. For example, a ChatGPT call costs 7 credits (5 + 2). Each tool description states its cost, and each result returns the credits charged and remaining. resolve_google_redirect costs 1 credit, with no surcharge. list_countries and list_states read fixed reference lists and charge nothing. See pricing.
Why is my API key in the URL?
Because several MCP clients cannot set custom headers. If yours can, use the Authorization header form instead and keep the key out of the path. If your client supports OAuth, use that and there is no key at all. The URL path accepts API keys only, never OAuth tokens.
What is the request timeout?
320 seconds. Sync scrapes can take up to five minutes server-side, so the client budget leaves headroom. For long-running batches use the async task API rather than MCP.
Are there agent skills for cloro?
Yes. cloro-dev/skills has one skill per surface (ChatGPT, Gemini, Google AI Mode, Google AI Overview, Google Search, Google News) and skills for SERP research, LLM answer monitoring and AI visibility tracking. Install them with npx skills add cloro-dev/skills. The skills tell the agent which tool or endpoint to call, what it costs, and how to read the result. They work with this server or with the REST API.
Learn more
- Integration guide: cloro.dev/docs/integrations/mcp
- API reference: cloro.dev/docs
- Agent skills: github.com/cloro-dev/skills
License
MIT. See LICENSE.
cloro MCPのよくある質問
cloro MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http mcp-server https://mcp.cloro.dev/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
cloro MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
cloro MCPが提供するツールは
9個のツールを提供しており、scrape_chatgpt, scrape_gemini, scrape_google_ai_mode, scrape_bing_aimode, scrape_googleなどがあります。
セルフホストする必要がありますか?
いいえ、ほとんどのユーザーには mcp.cloro.dev で提供されているホスト版の使用を推奨しています。
スクレイピングツールの使用にクレジットは消費されますか?
はい、各スクレイピングツールの呼び出しにおいて、APIレートに加えて2クレジットの同期追加料金が発生します。
なぜURLにAPIキーが含まれているのですか?
一部のMCPクライアントではカスタムヘッダーを設定できないため、それらのケースに対応できるようURLパスでAPIキー認証を行えるようにしています。
サーバーのリクエストタイムアウトはどのくらいですか?
最大5分かかる同期スクレイピングに対応するため、リクエストタイムアウトは320秒に設定されています。