Scout Intel MCP — The Google for AI Agents

Scout MCP
AI エージェント向けビジネス・市場インテリジェンス

---

AI エージェント向けの Google — ウェブページではなく、エージェントが推論できる、整然と構造化された JSON を返します。

Scout MCP を使うと、あらゆる AI エージェントが、構造化されたビジネスインテリジェンス、市場調査、競合分析にすぐにアクセスできます。DuckDuckGo、NewsAPI、Wikipedia、ウェブスクレイピング、ソーシャルプロフィールのデータを集約し、データソースごとの信頼度内訳とデータ品質評価を含む、Pydantic で検証された JSON レスポンスを返します。

---

目次

• クイックインストール
• 6 つのインテリジェンスツール
• データ品質評価
• 信頼度の内訳
• API リファレンス全文
• レスポンス例
• アーキテクチャ
• 設定
• 料金とレート制限
• セルフホスティング
• Docker
• 技術スタック
• データソース
• コントリビューション

---

クイックインストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "scout-mcp": {
      "command": "python",
      "args": ["-m", "scout_mcp.mcp_server"],
      "cwd": "/path/to/scout-mcp/src",
      "env": {
        "NEWS_API_KEY": "your-newsapi-key"
      }
    }
  }
}

Cursor

Cursor Settings > MCP に追加します。

{
  "scout-mcp": {
    "command": "python",
    "args": ["-m", "scout_mcp.mcp_server"],
    "cwd": "/path/to/scout-mcp/src",
    "env": {
      "NEWS_API_KEY": "your-newsapi-key"
    }
  }
}

VS Code（Copilot MCP）

.vscode/mcp.json に追加します。

{
  "servers": {
    "scout-mcp": {
      "command": "python",
      "args": ["-m", "scout_mcp.mcp_server"],
      "cwd": "/path/to/scout-mcp/src",
      "env": {
        "NEWS_API_KEY": "your-newsapi-key"
      }
    }
  }
}

pip（セルフホスト）

pip install scout-mcp
scout-mcp  # starts STDIO server for MCP clients

---

6 つのインテリジェンスツール

#	ツール	機能	プラン
1	scout_company	あらゆる企業の構造化インテリジェンス：業界、資金調達、技術スタック、競合、ニュース、主要人物	無料
2	scout_market	市場調査：市場規模、CAGR、主要企業、トレンド、成長要因、リスク	無料
3	scout_competitors	競合分析：ポジショニング、価格、強み、弱み、差別化要因	無料
4	scout_trends	トレンド追跡：センチメント分析、主要な動向、トレンドの方向性、関連トピック	無料
5	scout_product	製品インテリジェンス：価格、評価、機能、代替製品、最近の更新	無料
6	scout_person	著名人の調査：役職、経歴、実績、ソーシャルプロフィール	Pro

---

データ品質評価

すべてのレスポンスには data_quality_grade が含まれます。これは、エージェントがインテリジェンスの信頼性をすぐに判断できるようにする評価です。

評価	信頼度	意味
A+	90% 以上	非常に高い — 複数の高品質な情報源で確認済み
A	80～90%	高い — 複数の情報源による強力な裏付けあり
B	65～80%	良好 — 主要な情報源から確かなデータを取得
C	45～65%	普通 — 情報源が限られており、情報に欠落がある可能性あり
D	25～45%	低い — データが乏しいため、注意して扱ってください
F	25% 未満	不十分 — 利用可能なデータがごくわずか

エージェントによる評価の使い方

result = scout_company("Stripe")

if result["data_quality_grade"] in ("A+", "A"):
    # High confidence — safe to make decisions on this data
    proceed_with_analysis(result)
elif result["data_quality_grade"] == "B":
    # Good but verify key claims
    proceed_with_caveats(result)
else:
    # C/D/F — supplement with additional sources
    request_more_data(result)

---

信頼度の内訳

評価に加えて、すべてのレスポンスには、情報源ごとの信頼性を示す confidence_breakdown 辞書が含まれます。

{
  "confidence": 0.86,
  "data_quality_grade": "A",
  "confidence_breakdown": {
    "duckduckgo": {
      "score": 0.60,
      "reason": "8 results found"
    },
    "company_website": {
      "score": 0.90,
      "reason": "scraped stripe.com, 3 data points extracted"
    },
    "wikipedia": {
      "score": 0.90,
      "reason": "page found, structured data extracted"
    },
    "newsapi": {
      "score": 0.90,
      "reason": "6 articles found"
    },
    "competitor_extraction": {
      "score": 0.80,
      "reason": "5 competitors identified"
    }
  }
}

ソースの重み

全体の信頼度計算では、ソースごとに異なる重みが付けられます。

ソース	重み	理由
Wikipedia	3x	編集・構成されており、権威性が高い
NewsAPI	2x	新鮮で、専門的なジャーナリズム
Company Website	2x	一次情報で、最新性が最も高い
DuckDuckGo Search	1x	幅広い一方、品質にばらつきがある
Competitor Extraction	1x	派生した分析
Social Profiles	1x	補足情報

---

API リファレンス全体

ベース URL

POST /api/scout/{tool_name}

認証

X-Api-Key ヘッダーで API キーを渡してください。

curl -X POST /api/scout/company \
  -H "X-Api-Key: your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"name": "Stripe"}'

キーなしの場合は無料枠（1 日あたり 50 リクエスト）です。

ヘルスチェックと情報

エンドポイント	メソッド	説明
/api/	GET	サービス情報とツール一覧
/api/health	GET	ヘルスチェックと DuckDuckGo のバックオフ状態
/api/tools	GET	パラメーター、利用枠、グレードの説明を含むすべてのツール
/api/cache/stats	GET	キャッシュのヒット／ミス統計
/api/cache/clear	POST	キャッシュされた応答をすべて消去

ツールのエンドポイント

POST /api/scout/company

任意の企業について調査します。

パラメーター	型	必須	説明
name	string	はい	企業名（例：「Stripe」、「OpenAI」）
domain	string	いいえ	企業のドメイン（例：「stripe.com」）。省略すると自動検出されます。

応答フィールド： name、domain、description、industry、founded、headquarters、employee_range、funding、tech_stack、social_profiles、recent_news、top_competitors、key_people、confidence、confidence_breakdown、data_quality_grade、data_freshness、sources_used、sources_failed

---

POST /api/scout/market

任意の市場または業界について調査します。

パラメーター	型	必須	説明
query	string	はい	調査する市場（例：「AI SaaS」、「electric vehicles」）
depth	string	いいえ	"summary"（デフォルト）または "detailed"

応答フィールド： market_name、query、depth、market_size、market_size_projections、cagr、key_players、trends、growth_drivers、risks、source_links、confidence、confidence_breakdown、data_quality_grade

---

POST /api/scout/competitors

競合を見つけて分析します。

パラメーター	型	必須	説明
company_or_product	string	はい	企業名または製品名（例：「Notion」）
max	integer	いいえ	返す競合の最大数（デフォルト 10）

応答フィールド： target、competitors（{name, domain, positioning, pricing, strengths, weaknesses, key_differentiator} の配列）、market_positioning_summary、confidence、confidence_breakdown、data_quality_grade

---

POST /api/scout/trends

トレンドとセンチメントを追跡します。

パラメーター	型	必須	説明
topic	string	はい	追跡するトピック（例：「generative AI」）
timeframe	string	いいえ	"1d"、"7d"（デフォルト）、"30d"、"1y"

応答フィールド： topic、timeframe、sentiment（{score, label}）、trending_direction、key_developments、related_topics、social_buzz、confidence、confidence_breakdown、data_quality_grade

---

POST /api/scout/product

任意の製品に関する情報を取得します。

パラメーター	型	必須	説明
name	string	はい	製品名（例：「Slack」、「Vercel」）

応答フィールド： name、category、description、pricing、ratings、features、ideal_for、alternatives、recent_updates、confidence、confidence_breakdown、data_quality_grade

---

POST /api/scout/person (PRO)

著名人について調査します。Pro 以上のプランが必要です。

パラメーター	型	必須	説明
name	string	はい	人物の名前（例：「Sam Altman」）
company	string	いいえ	企業に関する情報（例：「OpenAI」）

レスポンスフィールド： name、current_role、company、location、background_summary、social_profiles、recent_activity、notable_achievements、confidence、confidence_breakdown、data_quality_grade

Free プランのユーザーには HTTP 403 を返します。

---

レスポンス例

scout_company("Stripe")

{
  "name": "Stripe",
  "domain": "stripe.com",
  "description": "Stripe, Inc. is an Irish-American multinational financial services and software as a service company...",
  "industry": "Software & Technology",
  "founded": "2010",
  "headquarters": "San Francisco",
  "top_competitors": ["PayPal", "Adyen", "Square", "Braintree", "Checkout.com"],
  "tech_stack": ["Next.js", "React"],
  "recent_news": [
    {"headline": "Stripe launches AI billing features", "source": "TechCrunch", "date": "2026-04-08"},
    {"headline": "Stripe revenue grows 30% in 2025", "source": "Bloomberg", "date": "2026-03-15"}
  ],
  "confidence": 0.86,
  "data_quality_grade": "A",
  "confidence_breakdown": {
    "duckduckgo": {"score": 0.60, "reason": "8 results found"},
    "company_website": {"score": 0.90, "reason": "scraped stripe.com, 3 data points extracted"},
    "wikipedia": {"score": 0.90, "reason": "page found, structured data extracted"},
    "newsapi": {"score": 0.90, "reason": "6 articles found"},
    "competitor_extraction": {"score": 0.80, "reason": "5 competitors identified"}
  },
  "data_freshness": "2026-04-12T12:00:00Z"
}

scout_trends("generative AI", timeframe="7d")

{
  "topic": "generative AI",
  "timeframe": "7d",
  "sentiment": {"score": 0.72, "label": "positive"},
  "trending_direction": "up",
  "key_developments": [
    {
      "headline": "OpenAI releases GPT-5.2 with reasoning capabilities",
      "date": "2026-04-10",
      "impact_level": "high",
      "source": "The Verge"
    }
  ],
  "related_topics": ["Large Language Models", "AI Safety", "Enterprise AI"],
  "confidence": 0.83,
  "data_quality_grade": "A",
  "confidence_breakdown": {
    "duckduckgo_news": {"score": 0.90, "reason": "10 news articles found"},
    "newsapi": {"score": 0.90, "reason": "4 articles found"},
    "web_search": {"score": 0.50, "reason": "5 web results for context"}
  }
}

scout_competitors("Notion")

{
  "target": "Notion",
  "competitors": [
    {
      "name": "Obsidian",
      "domain": "obsidian.md",
      "positioning": "Privacy-focused local-first knowledge base with Markdown",
      "strengths": ["Open source", "Free tier available", "Offline support"],
      "key_differentiator": "Local-first with plain Markdown files"
    },
    {
      "name": "Coda",
      "positioning": "All-in-one doc with app-building capabilities",
      "strengths": ["AI-powered features"],
      "key_differentiator": "Document-as-app paradigm"
    },
    {
      "name": "Logseq",
      "positioning": "Open-source outliner with bidirectional links"
    }
  ],
  "market_positioning_summary": "Found 7 competitors for Notion. Top alternatives: Obsidian, Coda, Logseq, Anytype, AppFlowy.",
  "confidence": 0.65,
  "data_quality_grade": "B",
  "confidence_breakdown": {
    "search_Notion alternative": {"score": 0.70, "reason": "8 results for 'Notion alternatives'"},
    "search_Notion vs competi": {"score": 0.60, "reason": "6 results for 'Notion vs competitors'"},
    "extraction_quality": {"score": 0.86, "reason": "7 competitors extracted and enriched"}
  }
}

---

アーキテクチャ

                      +------------------+
                      |  AI Agent        |
                      |  (Claude, etc.)  |
                      +--------+---------+
                               |
                    STDIO / SSE / REST
                               |
              +----------------+----------------+
              |          Scout MCP              |
              |  FastMCP 3.x + FastAPI REST     |
              +----------------+----------------+
              |  Cache (24h TTL, in-memory)     |
              |  Auth (API key, tier limits)     |
              |  Rate Limiter (per-key, daily)   |
              +----+--------+--------+----------+
                   |        |        |
          +--------+  +-----+--+  +--+--------+
          | DuckDuckGo| | NewsAPI | | Wikipedia |
          | (free)    | | (.org)  | | (free)    |
          +-----------+ +---------+ +-----------+
                   |                    |
          +--------+--------+  +-------+-------+
          | Web Scraper     |  | Social Profile |
          | (httpx + BS4)   |  | Detection      |
          +----------------+  +----------------+

指数バックオフ（DuckDuckGo）

DuckDuckGo の無料 API にはレート制限があります。Scout MCP は適応型バックオフでこれに対応します。

Success  : interval = 2s (base)
Failure 1: interval = 4s
Failure 2: interval = 8s
Failure 3: interval = 16s
Failure 4: interval = 32s
Failure 5: interval = 48s (cap)
Next success: interval resets to 2s

各呼び出しでは、処理を断念する前にもう一度再試行します。GET /api/health でバックオフの状態を確認できます。

競合他社抽出エンジン

競合他社の抽出には、350 語以上のストップワードを含む 6 つの正規表現パターンカテゴリを使用します。

1. VS パターン — 「X vs Y」に一致
2. カンマ／and 区切りのリスト — 「代替製品には X、Y、Z が含まれます」
3. 番号付き／箇条書きリスト — 「1. Asana 2. Monday 3. ClickUp」
4. 見出しパターン — 「Asana -- プロジェクト管理ツール」
5. 文脈パターン — 「X のような」や「X など」
6. タイトルケースの名称 — 競合他社に関する文脈の近くにある、大文字で始まる製品名

複数語の検証では、記事タイトル、動詞が前置された名称、代名詞が前置された名称、役職が後置された名称、人物名の可能性が高い名称、巨大企業の親会社名、プラットフォーム名を除外します。

---

設定

環境変数

変数	必須	デフォルト	説明
NEWS_API_KEY	はい	—	NewsAPI.org API キー（無料で取得）
SCOUT_API_KEY	いいえ	—	マスター API キー（「scale」プランが自動で割り当てられます）
MONGO_URL	自動	—	MongoDB 接続文字列（REST API サーバー用）
DB_NAME	自動	—	MongoDB データベース名
CORS_ORIGINS	いいえ	*	許可する CORS オリジン

キャッシュ設定

レスポンスはメモリ内（dict）に24 時間キャッシュされます。キャッシュの統計情報とクリア用エンドポイント：

# Check cache stats
curl /api/cache/stats

# Clear all cache
curl -X POST /api/cache/clear

---

料金とレート制限

プラン	料金	1 日あたりの上限	ツール	機能
Free	$0/月	50 リクエスト	6 個中 5 個	要約の詳細度、基本グレード
Pro	$29/月	1,000 リクエスト	6 個すべて	+ scout_person + 詳細な市場レポート
Scale	$99/月	10,000 リクエスト	6 個すべて	すべての機能 + 優先サポート

レート制限の情報は、各レスポンスの _meta フィールドに含まれます。

{
  "_meta": {
    "tier": "free",
    "remaining": 47
  }
}

---

セルフホスティング

ローカル開発

# Clone and install
git clone https://github.com/your-org/scout-mcp.git
cd scout-mcp/backend
pip install -e ".[dev,server]"

# Set up environment
echo "NEWS_API_KEY=your-key" > .env

# Run MCP server (STDIO for Claude Desktop)
cd src && python -m scout_mcp.mcp_server

# Run REST API server
uvicorn server:app --host 0.0.0.0 --port 8001 --reload

# Inspect with MCP Inspector
fastmcp inspect src/scout_mcp/mcp_server.py

テストの実行

# Test the API
curl -X POST http://localhost:8001/api/scout/company \
  -H "Content-Type: application/json" \
  -d '{"name": "OpenAI"}'

# Check health + backoff status
curl http://localhost:8001/api/health

# List all tools
curl http://localhost:8001/api/tools

---

Docker

FROM python:3.12-slim
WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends gcc libxml2-dev libxslt1-dev && rm -rf /var/lib/apt/lists/*
COPY pyproject.toml .
COPY src/ src/
RUN pip install --no-cache-dir .
EXPOSE 8001
CMD ["python", "-c", "from scout_mcp.mcp_server import mcp; mcp.run(transport='sse', port=8001)"]

# Build and run
docker build -t scout-mcp .
docker run -p 8001:8001 -e NEWS_API_KEY=your-key scout-mcp

---

技術スタック

コンポーネント	技術	用途
MCP フレームワーク	FastMCP 3.x	ツールの登録、STDIO/SSE トランスポート
REST API	FastAPI	テスト用 HTTP エンドポイント
HTTP クライアント	httpx	非同期ウェブスクレイピング
HTML パーサー	BeautifulSoup4 + lxml	構造化データの抽出
検索	DuckDuckGo (ddgs)	無料のウェブ検索とニュース検索
ニュース	NewsAPI.org	プロ向けニュース記事
ナレッジ	Wikipedia API	構造化された背景情報
検証	Pydantic 2.x	レスポンスモデルの検証
キャッシュ	メモリ内 dict（24 時間 TTL）	レスポンスのキャッシュ
サーバー	uvicorn	ASGI 本番サーバー

---

データソース

ソース	API キー？	費用	レート制限	信頼性
DuckDuckGo Search	いいえ	無料	ソフト制限（バックオフ）	変動あり
DuckDuckGo News	いいえ	無料	ソフト制限（バックオフ）	変動あり
NewsAPI.org	はい	無料プラン	100 件／日	高
Wikipedia API	いいえ	無料	無制限（礼儀正しく利用）	非常に高
Web Scraping (httpx)	いいえ	無料	サイトごとの制限	中
Social Profile Detection	いいえ	無料	DuckDuckGo 経由	変動あり

今後追加予定のソース

• Crunchbase API（資金調達データ）
• SimilarWeb API（トラフィックデータ）
• GitHub API（開発者ツール）
• SEMrush API（SEO データ）

---

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/my-feature
3. 開発用依存関係をインストールします：pip install -e ".[dev]"
4. 変更を加えます
5. テストを実行します：pytest
6. プルリクエストを送信します

新しいデータソースの追加

1. src/scout_mcp/sources/your_source.py を作成します
2. 構造化データを返す非同期関数を実装します
3. src/scout_mcp/tools/ 内の関連ツールにソースを追加します
4. ソースごとの信頼度スコアリングを追加します
5. この README を更新します

新しいツールの追加

1. src/scout_mcp/tools/your_tool.py を作成します
2. models.py に Pydantic モデルを追加します（confidence_breakdown と data_quality_grade を含めます）
3. @mcp.tool() を使って mcp_server.py に登録します
4. server.py に REST エンドポイントを追加します
5. この README を更新します

---

ライセンス

MIT

---

FastMCP、httpx、BeautifulSoup4、Pydantic で構築
Scout MCP v0.1.0

---

🚀 ProfitSpot MCP もぜひご覧ください — AI エージェント向けのクロスチェーン DeFi インテリジェンスです。リスク評価付き利回り、モンテカルロシミュレーション、86 のチェーンにわたる大口保有者の追跡を提供します。