BusyBee — Social Media Data

BusyBee MCP

AI エージェント向けの公開ソーシャルメディアデータ。 10 個のビジネスレベルのツールと 1 つのスキーマで、TikTok、Instagram、YouTube、X（Twitter）、Douyin、Xiaohongshu に対応します。

エージェントに 「今、TikTok で最も急成長しているコーヒー系クリエイターは誰で、コメント欄ではどんな不満が出ている？」 と尋ねると、1 回の会話で実際のデータに基づいて答えてくれます。

Endpoint    https://lucydomi.com/mcp
Protocols   MCP Streamable HTTP · MCP SSE (legacy) · REST/JSON · stdio
Tools       10
Billing     pay per call; every response returns cost_usd + balance_usd

---

あらゆる種類のエージェントに対応

「AI 向けソーシャルデータ」製品の多くは、トランスポートを 1 つだけ提供し、クライアントがそれに対応していることを期待します。このサーバーは 4 つの方式に対応し、同じホスト上で、どの方式でも同じ 10 個のツールを利用できます。

エージェント	対応方式	接続方法
Claude Code	Streamable HTTP	claude mcp add busybee --transport http https://lucydomi.com/mcp --header "Authorization: Bearer sk-..."
Cursor / Cline / Windsurf / VS Code	Streamable HTTP	mcp.json に追加してください（下記を参照）
Claude Desktop	stdio	BUSYBEE_API_KEY を設定して uvx busybee-mcp を実行します
古い MCP クライアント（2024-11 時代）	SSE のみ	https://lucydomi.com/sse + https://lucydomi.com/messages/
Dify / n8n / Coze / FastGPT	OpenAPI / プレーン HTTP	https://lucydomi.com/mcp/openapi.json（3.1）をインポートします。古いインポーターでは ?spec=3.0 を使用します
LangChain / LlamaIndex / カスタムコード	tools JSON または HTTP	https://lucydomi.com/mcp/tools?format=openai を使用するか、REST を直接呼び出します
GPT Actions / Zapier / Make	OpenAPI 3.x	同じ仕様の URL とベアラー認証を使用します
URL を GET することしかできないもの	クエリ文字列	https://lucydomi.com/mcp/v1/search_creators?platform=tiktok&keyword=coffee&api_key=sk-...

検出ドキュメント（機械可読形式で、利用可能な機能をエージェントに知らせます）：https://lucydomi.com/mcp/info

---

10 個のツール

ツール	回答できる質問
list_platforms	利用可能なプラットフォーム、各プラットフォームが対応するツール、必要なキーグループ
search_creators	「TikTok で中規模のコーヒー系クリエイターを探して」
search_posts	「今週、コールドブリューについてどんな投稿がある？」
get_creator	「このアカウントの規模は？プロフィールには何と書かれている？」
list_creator_posts	「このアカウントが最近投稿した内容は？」
get_post	「この動画 1 件の詳細を教えて」
get_comments	「この投稿のコメント欄では何と言われている？」
get_trending	「今、Douyin で何がトレンドになっている？」
get_comment_insights	「コメント欄を要約して。感情、質問、苦情を教えて」
check_balance	「クレジットはあとどれくらい残っている？」

get_comment_insights は、常に開いたままにしておく人が多いツールです。コメントをサンプリングし、感情の内訳、質問の割合、頻出フレーズ、いいね数の多いコメントを返します。そのため、エージェントは生データを 50 行並べるのではなく、「ユーザーが実際に何を求めているのか」 に答えられます。

---

すべてのプラットフォームで共通のスキーマ

データが TikTok、Instagram、YouTube、X、Douyin、Xiaohongshu のどれから来た場合でも、フィールド名は同じです。

{
  "ok": true, "platform": "tiktok", "tool": "search_posts", "count": 6,
  "items": [
    {
      "platform": "tiktok",
      "id": "7690199760430566669",
      "url": "https://www.tiktok.com/@laceyglasley/video/7690199760430566669",
      "author": { "id": "7066058701889012782", "handle": "laceyglasley", "name": "Lacey" },
      "text": "Salted Honey Spanish Latte … #coffeetok #spanishlatte",
      "created_at": "2026-09-27T13:03:24+00:00",
      "stats": { "likes": 68357, "comments": 165, "shares": 7691, "views": 1009685, "collects": 17806 },
      "cover": "https://…"
    }
  ],
  "cost_usd": 0.003, "balance_usd": 3.93
}

これはモックアップではなく、実際のレスポンスです — ライブ呼び出しから取得したもので、シェア URL のクエリ文字列とキャプションだけを短縮しています。完全な生レスポンスを 2 件、リポジトリに収録しています。 examples/1_tiktok_coffee.json（search_posts）と examples/2_youtube_insights.json（20 件のコメントに対するコメントインサイト）。

すべてのレスポンスには cost_usd と balance_usd が含まれているため、エージェントが自分で予算を管理でき、タスクに実際にかかった費用も確認できます。

---

クライアントごとのセットアップ

まずキーが必要です。lucydomi.com に登録し、Console → API Keys → New key（sk-…）を選択します。海外向けプラットフォームと中国向けプラットフォームでは、異なるキーグループを使用します。

Claude Code

claude mcp add busybee --transport http https://lucydomi.com/mcp \
  --header "Authorization: Bearer sk-YOUR_KEY"

Cursor / Cline / Windsurf / VS Code（~/.cursor/mcp.json）

{
  "mcpServers": {
    "busybee": {
      "url": "https://lucydomi.com/mcp",
      "headers": { "Authorization": "Bearer sk-YOUR_KEY" }
    }
  }
}

Claude Desktop（ローカル stdio）

{
  "mcpServers": {
    "busybee": {
      "command": "uvx",
      "args": ["busybee-mcp"],
      "args": ["busybee-mcp"],
      "env": { "BUSYBEE_API_KEY": "sk-YOUR_KEY" }
    }
  }
}

レガシー SSE クライアント

SSE URL      https://lucydomi.com/sse
Messages URL https://lucydomi.com/messages/?session_id=<from the SSE event>
Header       Authorization: Bearer sk-YOUR_KEY

Dify / n8n / Coze / GPT Actions

OpenAPI スキーマをインポートし、認証方式を Bearer sk-YOUR_KEY に設定します。インポーターが 3.1 を受け付けない場合は、3.0 のビューを使用してください。

プラットフォーム	貼り付け先	URL
Dify	Tools → Custom → Add OpenAPI tool	https://lucydomi.com/mcp/openapi.json?spec=3.0
n8n	HTTP Request ノード、または認証情報で保護された API としてインポート	https://lucydomi.com/mcp/openapi.json
Coze	Plugin → Import from OpenAPI	https://lucydomi.com/mcp/openapi.json?spec=3.0
OpenAI GPT Actions	Actions → Import from URL	https://lucydomi.com/mcp/openapi.json

サーバー側のエンドポイントはスキーマから自動的に決まり、各オペレーションはツール名に 1 対 1 で対応します。そのため、スキーマ内の search_posts は POST https://lucydomi.com/mcp/v1/search_posts です。

LangChain / カスタム Python（MCP は不要）

import json, urllib.request
req = urllib.request.Request(
    "https://lucydomi.com/mcp/v1/search_creators",
    data=json.dumps({"platform": "tiktok", "keyword": "coffee", "limit": 3}).encode(),
    headers={"Content-Type": "application/json", "Authorization": "Bearer sk-YOUR_KEY"},
)
print(json.load(urllib.request.urlopen(req)))

関数呼び出し用のツールスキーマ：GET https://lucydomi.com/mcp/tools?format=openai

ローカルパッケージ

pip install busybee-mcp
BUSYBEE_API_KEY=sk-YOUR_KEY busybee-mcp          # stdio
BUSYBEE_API_KEY=sk-YOUR_KEY busybee-mcp http     # serve all transports on :3013

---

知っておきたい設計上の判断

• ツールは 1,000 個ではなく 10 個です。 エンドポイントではなく、ビジネス上の目的を指定します。モデルが参照するツールが増えるほど、選択を間違える頻度が高まり、コストも増えます。
• 正規化されたフィールド。 author / text / created_at / stats は、どのプラットフォームでも同じ意味です。
• すべてのプロトコルで実装を共有。 MCP、SSE、REST は同じディスパッチ層を共有するため、クライアント間で動作に差が生じません。
• 呼び出しごとの従量課金、エンドポイントごとの価格設定。 安価な呼び出しは 1 セント未満です。価格はコンソールで確認できます。
• 結果にコストを明示。 すべてのレスポンスに cost_usd と balance_usd が含まれます。
• 失敗した呼び出しには課金されません。
• 簡潔なエラー。 スタックトレース、サードパーティベンダー名、上流のドキュメントへのリンクがエージェントのコンテキストに漏れることはありません。
• CORS が有効なため、ブラウザベースのエージェントやウェブウィジェットから直接呼び出せます。

エラー

error	意味	対処方法
no_api_key	キーが指定されていません	Authorization: Bearer sk-...、X-API-Key、または ?api_key= を追加します
unauthorized	キーが無効か、削除されています	コンソールで新しいキーを発行します
insufficient_balance	クレジットが不足しています	チャージします
forbidden	キーのグループがそのプラットフォームに対応していません	適切なグループでキーを作成します
rate_limited	リクエストが多すぎます	時間をおいて再試行します
unsupported_tool	そのプラットフォームではツールを利用できません	list_platforms を呼び出して対応状況を確認します
upstream_error	プロバイダーで一時的な障害が発生しています	1 回再試行します。課金されません

対象範囲とコンプライアンス

BusyBee が提供するのは公開ソーシャルメディアデータのみで、利用できるのは中国本土以外のユーザーに限られます。個人のプロファイリング、非公開アカウントのスクレイピング、エンゲージメントの操作、または正当な法的根拠のない個人データを使ったモデルのトレーニングには使用しないでください。データポリシーをご覧ください。

ライセンス

MIT — LICENSE をご覧ください。このリポジトリはクライアント側の MCP サーバーです。ホスト型サービスは別途従量課金されます。

---

中国語での概要

BusyBee MCP は、TikTok、Instagram、YouTube、X、抖音、小红书の 6 つのプラットフォームの公開データを、10 個のビジネスレベルのツールと統一されたフィールドセットにまとめています。1 台のサーバーで 4 種類の接続方式に対応します。

AI ツール	接続先
Claude Code / Cursor / Cline（新しい MCP）	https://lucydomi.com/mcp
旧バージョンの SSE のみを認識するクライアント	https://lucydomi.com/sse
Dify / n8n / Coze / GPT Actions（OpenAPI）	https://lucydomi.com/mcp/openapi.json
HTTP リクエストを送信できるプログラム	https://lucydomi.com/mcp/v1/<工具名>

• キー：登録後、コンソールで sk- から始まる文字列を作成します
• 課金：呼び出しごとの従量課金です。各レスポンスには今回の費用と残高が含まれ、失敗しても課金されません
• エラーは簡潔な中国語または英語で表示され、上流の情報は公開されません