Capabilities: ask first, then decide which platform to pull

Parameter

Why it deserves its own step

Hardcoding “can this platform search by keyword” is a common source of incidents: once it is baked in, a change on the platform side makes the call return empty silently, and an empty result looks the same in the data as “this term really has no content”. Ask the capability table once and skip unsupported branches explicitly, and your logs show at a glance whether it was “unsupported” or “no data”.

Response shape

platforms[] Each entry carries the platform id, its Chinese label and the available tools; note documents the group and authorization boundaries. Tool names match our docs, so they map directly onto enums in your code.

When not to use it

A script that uses one platform only and already works can skip this call; but anything involving cross-platform comparison or writing several platforms into one store should start here.

Copy and run

curl -s https://lucydomi.com/mcp/v1/list_platforms \
  -H "Authorization: Bearer $BUSYBEE_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{}'

import os, json, urllib.request

KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
    "https://lucydomi.com/mcp/v1/list_platforms",
    data=json.dumps({}).encode(),
    headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
    method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
    print(it.get("url"), it.get("text", "")[:60])

Real response sample

A real production response below — truncated to one item, billing fields removed.

{ "ok": true, "count": 6, "platforms": [ { "platform": "tiktok", "label": "TikTok", "region": "overseas", "tools": [ "get_comments", "get_creator", "get_post", "list_creator_posts", "search_creators", "search_posts" ], "key_group": "overseas video (ov_video)" }, { "platform": "instagram", "label": "Instagram", "region": "overseas", "tools": [ "get_comments", "get_creator", "list_creator_posts", "search_creators" ], "key_group": "overseas social (ov_social)" }, { "platform": "youtube", "label": "YouTube", "region": "overseas", "tools": [ "get_comments", "get_creator", "get_post", "list_creator_posts", "search_posts" ], "key_group": "overseas video (ov_video)" }, { "platform": "twitter", "label": "X / Twitter", "region": "overseas", "tools": [ "get_comments", "get_creator", "list_creator_posts", "search_posts" ], "key_group": "overseas social (ov_social)" }, { "platform": "douyin", "label": "Douyin", "region": "mainland", "tools": [ "get_comments", "get_creator", "get_post", "get_trending", "list_creator_posts", "search_creators", "search_posts" ], "key_group": "mainland video (cn_video)" }, { "platform": "xiaohongshu", "label": "Xiaohongshu", "region": "mainland", "tools": [ "get_comments", "get_creator", "get_post", "list_creator_posts", "search_creators", "search_posts" ], "key_group": "mainland content (cn_content)" } ], "note": "Mainland platforms (douyin / xiaohongshu) need a key from the mainland group; overseas platforms use the overseas group." }

FAQ

Related