§01

MCP setup: start by copying the prompt

Give the setup prompt to your agent. Connection tests and compatibility settings stay out of the initial setup flow.

FAST PATH / ONE URL

Connect remote MCP with one URL

After you log in, this page generates a short-lived, one-time connection token instead of putting the default API key in the URL.Anonymous visitors see only a safe URL template, preventing credential exposure.

Setup prompt · paste directly to your agent

Connect claudebaby MCP to the current client using remote Streamable HTTP first; this route requires no local installation. If the client does not support remote MCP, use the local stdio installation instructions below.
My API key: <paste your API key>
First read https://claudebaby.cn/.well-known/mcp.json, then configure the aggregate Streamable HTTP endpoint (https://claudebaby.cn/mcp).
The aggregate endpoint exposes business and all live platform tools through one MCP connection. Use an individual platform endpoint only for troubleshooting.
Use the Authorization header with the value Bearer <my API key>. Then call tools/list to verify the connection and tell me whether it succeeded. If this client does not support remote MCP, explain how to use the local stdio fallback.

MCP URL · preview

https://claudebaby.cn/mcp

Generate after login

Choose an access methodInstall Skill or MCP independently, combine them, or keep using the original Prompt flow.

Workflow

Install the ClaudeBaby Skill

Install the standard SKILL.md so the agent follows a consistent research, comparison, and citation workflow. The Skill stores no key and works as a standalone install.

Install for Codex

mkdir -p "$HOME/.codex/skills/claudebaby" && curl -fsSL "https://raw.githubusercontent.com/lingling1989r/claudebaby/main/skills/claudebaby/SKILL.md" -o "$HOME/.codex/skills/claudebaby/SKILL.md"

Install for Claude Code

mkdir -p "$HOME/.claude/skills/claudebaby" && curl -fsSL "https://raw.githubusercontent.com/lingling1989r/claudebaby/main/skills/claudebaby/SKILL.md" -o "$HOME/.claude/skills/claudebaby/SKILL.md"

View the complete SKILL.md →

Live data

Connect ClaudeBaby MCP

Connect the remote Streamable HTTP aggregate endpoint. Pass the key only through an environment variable or the Authorization header.

Claude Code · MCP

claude mcp add --scope user --transport http claudebaby https://claudebaby.cn/mcp --header "Authorization: Bearer $CB_KEY"

See Advanced / compatibility options below for other clients.

Original flow

Copy the Prompt with your key

Give this directly to an agent without learning the configuration format. The visible preview is always masked; the complete key exists only in the copied value.

Setup prompt · paste directly to your agent

Connect claudebaby MCP to the current client using remote Streamable HTTP first; this route requires no local installation. If the client does not support remote MCP, use the local stdio installation instructions below.
My API key: <paste your API key>
First read https://claudebaby.cn/.well-known/mcp.json, then configure the aggregate Streamable HTTP endpoint (https://claudebaby.cn/mcp).
The aggregate endpoint exposes business and all live platform tools through one MCP connection. Use an individual platform endpoint only for troubleshooting.
Use the Authorization header with the value Bearer <my API key>. Then call tools/list to verify the connection and tell me whether it succeeded. If this client does not support remote MCP, explain how to use the local stdio fallback.

Advanced / compatibility optionsJSON · stdio · SSE · per-platform endpoints

Aggregate and compatibility paths: the cloud governance route is the same

01Local stdio aggregate routerRecommended

Agent / MCP ClientClaude · WorkBuddy · Cursor

Client bridgeAggregate router installed with one command

claudebaby.cn cloud aggregate routerAuthentication · rate limiting · metering · Business + platform routing

Business + PlatformsAnalysis and native tools

Copy one command to install and connect; the aggregate router discovers live platforms automatically and is the best option for first-time setup.

02Remote Streamable HTTP / SSECompatibility

Agent / MCP ClientClients with remote MCP support

claudebaby.cn cloud gatewayAggregate-router MCP / platform MCP

Remote compatibility endpointNo local bridge required

Clients with remote MCP support can configure the aggregate router directly; platform-level URLs remain available for advanced use.

Neither option exposes upstream data-source keys; the only difference is whether discovery and forwarding go through the local aggregate router.

Sign up
Open Console and create an account with your email and password.
Issue API key
Issue a key on the console’s API Key page. The plaintext appears only once, so store it in a secret manager immediately.
Top up
Pay online by PayPal or Alipay from the Console Top up page for instant credit. For large payments or bank transfers, contact sales on WeChat at aoxueluoluo. Your balance and credit history update as soon as the payment is posted.
Configure an MCP client
Copy the command or configuration above to connect the aggregate router; you can also open API details to try the REST API.

Local stdio aggregate-router command

# One command: install the bridge and connect Business + live platforms
claude mcp add claudebaby --scope user --env CLAUDEBABY_API_KEY="$CB_KEY" -- uvx --from "git+https://github.com/lingling1989r/claudebaby.git#subdirectory=mcps" claudebaby-mcp --platforms all

Client JSON configuration

{
  "mcpServers": {
    "claudebaby": {
      "type": "http",
      "url": "https://claudebaby.cn/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

# For an advanced platform endpoint, change the URL to https://claudebaby.cn/mcp/<platform>; the dedicated Business endpoint is https://claudebaby.cn/mcp/business

stdio bridge (compatibility details)

# For clients that only support stdio: the same command above installs and connects it
claude mcp add claudebaby --scope user --env CLAUDEBABY_API_KEY="$CB_KEY" -- uvx --from "git+https://github.com/lingling1989r/claudebaby.git#subdirectory=mcps" claudebaby-mcp --platforms all

# To preinstall the executable, run:
uv tool install --from "git+https://github.com/lingling1989r/claudebaby.git#subdirectory=mcps" claudebaby-mcp

# Optional check:CLAUDEBABY_API_KEY=cb_live_xxx claudebaby-mcp --platforms all --check

Configure by client: n8n, WorkBuddy, Codex, Claude

n8n

Workflow node: enter one endpoint and load tools automatically

Streamable HTTP

n8n · MCP server

Endpointhttps://claudebaby.cn/mcp

Server TransportHTTP Streamable

AuthenticationConfigure the Authorization header

Tools to IncludeAll

Create or open an AI Agent workflow
Add an MCP Client / MCP Server node
Paste the URL, choose HTTP Streamable, and load all tools

Copy configuration

Endpoint: https://claudebaby.cn/mcp
Server Transport: HTTP Streamable
Authorization: Bearer <API Key>
Tools to Include: All

WorkBuddy

Custom connector: import JSON and enable it

Streamable HTTP

WorkBuddy · MCP server

Entry pointExpert → Choose connector → Custom connector

TypeStreamable HTTP

URLhttps://claudebaby.cn/mcp

StatusConnected · choose tools

Open the expert panel and choose custom connector
Click configure and paste the JSON
Save, return to the MCP list, and enable claudebaby

Copy configuration

{
  "mcpServers": {
    "claudebaby": {
      "type": "streamableHttp",
      "url": "https://claudebaby.cn/mcp",
      "headers": {"Authorization": "Bearer <API Key>"},
      "name": "claudebaby",
      "description": "Cross-platform e-commerce and social-data MCP"
    }
  }
}

Codex

CLI or config.toml: desktop and CLI share the same config

Streamable HTTP

Codex · MCP server

SettingsMCP → Add server

Nameclaudebaby

TransportStreamable HTTP

URLhttps://claudebaby.cn/mcp

Open MCP servers in Codex settings
Add claudebaby and choose Streamable HTTP
Save and verify with codex mcp list

Copy configuration

# Store the API Key in an environment variable; Codex reads only the variable name.
export CLAUDEBABY_API_KEY="<API Key>"
codex mcp add claudebaby --url "https://claudebaby.cn/mcp" --bearer-token-env-var CLAUDEBABY_API_KEY
codex mcp list

# Or add to ~/.codex/config.toml
[mcp_servers.claudebaby]
url = "https://claudebaby.cn/mcp"
http_headers = { Authorization = "Bearer <API Key>" }

Claude

One command for Claude Code; import JSON in Claude Desktop

Streamable HTTP

Claude · MCP server

Claude Codeclaude mcp add

TransportHTTP / Streamable HTTP

Serverclaudebaby

Verify/mcp or claude mcp list

Run the command in Claude Code, or open Customize in Desktop
Add a remote MCP server and paste the URL
Run /mcp in a session and confirm the tools appear

Copy configuration

claude mcp add --transport http --scope user claudebaby "https://claudebaby.cn/mcp" --header "Authorization: Bearer <API Key>"
claude mcp list

// Claude Desktop / generic JSON
{
  "mcpServers": {
    "claudebaby": {
      "type": "streamableHttp",
      "url": "https://claudebaby.cn/mcp",
      "headers": {"Authorization": "Bearer <API Key>"}
    }
  }
}

Remote Streamable HTTP, SSE, REST, and per-platform endpoints remain available for compatibility; see the complete machine-readable list at https://claudebaby.cn/.well-known/mcp.json; for manual debugging, see API details.

Advanced / compatibility options: per-platform endpointsStreamable HTTP · SSE · stdio

§03

Platform MCP endpoints (compatibility)

Platform	Market / domain	MCP（Streamable HTTP）	MCP（SSE）	stdio
1688	Domestic · e-commerce	https://claudebaby.cn/mcp/1688	https://claudebaby.cn/sse/1688	claudebaby-mcp --platform 1688
amazon	International · e-commerce	https://claudebaby.cn/mcp/amazon	https://claudebaby.cn/sse/amazon	claudebaby-mcp --platform amazon
douyin	Domestic · social	https://claudebaby.cn/mcp/douyin	https://claudebaby.cn/sse/douyin	claudebaby-mcp --platform douyin
facebook	International · social	https://claudebaby.cn/mcp/facebook	https://claudebaby.cn/sse/facebook	claudebaby-mcp --platform facebook
linkedin	International · social	https://claudebaby.cn/mcp/linkedin	https://claudebaby.cn/sse/linkedin	claudebaby-mcp --platform linkedin
reddit	International · social	https://claudebaby.cn/mcp/reddit	https://claudebaby.cn/sse/reddit	claudebaby-mcp --platform reddit
shopee	International · e-commerce	https://claudebaby.cn/mcp/shopee	https://claudebaby.cn/sse/shopee	claudebaby-mcp --platform shopee
temu	International · e-commerce	https://claudebaby.cn/mcp/temu	https://claudebaby.cn/sse/temu	claudebaby-mcp --platform temu
tiktok	International · social	https://claudebaby.cn/mcp/tiktok	https://claudebaby.cn/sse/tiktok	claudebaby-mcp --platform tiktok
tiktokshop	International · e-commerce	https://claudebaby.cn/mcp/tiktokshop	https://claudebaby.cn/sse/tiktokshop	claudebaby-mcp --platform tiktokshop
walmart	International · e-commerce	https://claudebaby.cn/mcp/walmart	https://claudebaby.cn/sse/walmart	claudebaby-mcp --platform walmart
x	International · social	https://claudebaby.cn/mcp/x	https://claudebaby.cn/sse/x	claudebaby-mcp --platform x
xiaohongshu	Domestic · social	https://claudebaby.cn/mcp/xiaohongshu	https://claudebaby.cn/sse/xiaohongshu	claudebaby-mcp --platform xiaohongshu
youtube	International · social	https://claudebaby.cn/mcp/youtube	https://claudebaby.cn/sse/youtube	claudebaby-mcp --platform youtube

The hostname and /mcp/ prefix are shared; only the final segment is the platform name. Use https://claudebaby.cn/mcp/<platform> and replace the placeholder with a live platform slug. If you use your own reverse-proxy domain, replace the URL segment by segment.

The host and path prefix are shared; the platform name is the only variable. Choose the matching URL for a remote client that uses one platform. For multiple platforms, use the aggregate router above instead of configuring each platform separately.

§03

REST quick reference

curl

export CB_KEY=cb_live_xxx

# Endpoint catalog (tools per platform; no authentication required)
curl -s https://claudebaby.cn/v1/meta/tools

# Fetch data: choose a platform, domain, and tool from the catalog; send arguments as JSON
PLATFORM=your_platform
DOMAIN=social_or_ecommerce
TOOL=tool_name
curl -s -X POST "https://claudebaby.cn/v1/$DOMAIN/$PLATFORM/tools/$TOOL" \
  -H "Authorization: Bearer $CB_KEY" -H "Content-Type: application/json" \
  -d '{}'

# Check balance and usage
curl -s https://claudebaby.cn/api/me -H "Authorization: Bearer $CB_KEY"
curl -s "https://claudebaby.cn/api/usage?groupBy=day" -H "Authorization: Bearer $CB_KEY"

Also accepts X-API-Key. Issue keys in the console; plaintext is shown once. During rotation, give the old key a grace period to avoid interrupting production tasks. Every response includes X-Request-Id; include it in support requests to trace the full request path.

§04

Machine-readable entry points

The pages above are for people; this group is for agents. All four setup methods above derive from these endpoints.

Entry point	Content	Purpose
/.well-known/mcp.json	Platform catalog + MCP endpoint for each platform	Discover and mount automatically
/openapi.json	Data-plane OpenAPI 3.1 + error-code catalog	Generate clients / validate the contract
/pricing.json	Plans · top-up pricing · credit factors · per-platform pricing	Calculate cost before calling
/llms.txt	Plain-text site index	Readable by agents without HTML
/api/me · /api/usage	Balance / quota / failure rate	Self-check with an API key

§05

Endpoint overview

The tool name is the final REST path segment. The same tools are exposed through MCP, whose structuredContent matches the REST response byte for byte.The complete list grouped by domestic / international × social / e-commerce is in <a href="/api-reference">API reference</a>。

1688E-commerceLive

Call pattern: POST /v1/ecommerce/1688/tools/{tool} (5 endpoints)

Endpoint	Input	Note
ali1688_category_tree	node_id:string	Browse the 1688 category tree.
ali1688_product_search	node_id:string · supplier_name:string · price_min:string · price_max:string · cumulative_sales_min:string · cumulative_sales_max:string · recent_sales_min:string · recent_sales_max:string · repurchase_rate_min:string · sku_count_min:string · stock_count_min:string · page:integer	Search 1688 offers / suppliers with multi-dimensional filters.
ali1688_product_request	product_id*:string	Full detail record of a single 1688 offer.
ali1688_product_variations	product_id*:string	SKU / variation data of a 1688 offer.
ali1688_similar_product	search_name*:string · page:integer	Sourcing / wholesale suppliers for a product name — procurement cost view.

amazonE-commerceLive

Call pattern: POST /v1/ecommerce/amazon/tools/{tool} (20 endpoints)

Endpoint	Input	Note
category_tree	site:string · node_id:string	Browse the Amazon category tree; omit node_id for the top two levels.
category_name_search	name*:string · site:string	Find Amazon sub-categories by name and get their node ids.
category_report	node_id*:string · site:string	Top-100 best sellers of an Amazon sub-category, real time.
category_report_from_history	node_id:string · start_date:string · end_date*:string · site:string	Top-100 best sellers of an Amazon sub-category in a past date range.
category_trend	node_id*:string · trend_index:string · site:string	Historical trend of an Amazon sub-category market.
category_keywords	node_id*:string · page:integer · site:string	Core keywords of an Amazon sub-category market.
product_search	search_name:string · brand:string · seller_name:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · rating_min:string · rating_max:string · rating_count_min:string · rating_count_max:string · page:integer · site:string	Search live Amazon products with multi-dimensional filters.
product_search_from_name	name*:string · page:integer · site:string	Search Amazon products by name; up to 20 per page.
product_detail	asin*:string · site:string	Full detail record of a single Amazon product (one ASIN per call).
product_trend	asin*:string · trend_type:string · site:string	Historical trend of an Amazon product (sales / price / rank).
product_reviews	asin*:string · review_type:string · site:string	Up to 100 Amazon user reviews of a product from the last year.
product_customers_say	asin*:string · site:string	Amazon `Customers Say` summary distilled from a product's reviews.
product_variations	asin*:string · page:integer · site:string	Child-ASIN variation breakdown of an Amazon parent product.
product_traffic_terms	asin*:string · page:integer · site:string	Keywords an Amazon product has recently been exposed under.
product_ranking_trend_by_keyword	asin:string · keyword:string · page:integer · site:string	Exposure-ranking trend of an Amazon product under one keyword.
keyword_list	site:string · page:integer · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string	Live trending keyword list for an Amazon site, by weekly search volume.
keyword_detail	keyword*:string · site:string	Detail record of one trending Amazon keyword.
keyword_trend	keyword*:string · site:string	Historical trend of an Amazon keyword (volume / rank / CPC).
keyword_extends	keyword*:string · site:string · page:integer	Extended / long-tail keywords derived from an Amazon keyword.
keyword_search_results	keyword*:string · site:string · page:integer · position_type:string	Products holding organic positions for an Amazon keyword.

douyinSocialLive

Call pattern: POST /v1/social/douyin/tools/{tool} (4 endpoints)

Endpoint	Input	Note
douyin_user_profile	username*:string	Public profile of a Douyin account.
douyin_post_detail	post_id*:string	Single Douyin video with its author and counters.
douyin_post_comments	post_id*:string · cursor:string · count:integer	Top-level comments of a Douyin video.
douyin_search_videos	query*:string · cursor:string · sort_type:string · publish_time:string	Keyword search over Douyin videos.

facebookSocialLive

Call pattern: POST /v1/social/facebook/tools/{tool} (3 endpoints)

Endpoint	Input	Note
facebook_page_profile	url*:string	Fetch a public Facebook page profile.
facebook_page_posts	url*:string · limit:integer	Fetch recent public posts from a Facebook page.
facebook_post_detail	url*:string	Fetch a public Facebook post and its engagement data.

linkedinSocialLive

Call pattern: POST /v1/social/linkedin/tools/{tool} (3 endpoints)

Endpoint	Input	Note
linkedin_user_profile	url*:string	Public profile of a LinkedIn member.
linkedin_company_profile	url*:string	Public page of a LinkedIn company.
linkedin_post_detail	url*:string	Single LinkedIn post or article.

redditSocialLive

Call pattern: POST /v1/social/reddit/tools/{tool} (3 endpoints)

Endpoint	Input	Note
reddit_search_posts	subreddit:string · query:string · days:integer · limit:integer	Search posts in a subreddit by keyword within a time window. Returns up to `limit` matches, oldest first. `limit` is also the cost control:…
reddit_get_thread	post_id*:string · top_n:integer	Fetch the comment tree of a single post, optionally only the top N.
reddit_search_comments	subreddit:string · query:string · days:integer · limit:integer	Search comments in a subreddit by keyword within a time window. Returns up to `limit` matches, oldest first. `limit` is also the cost contr…

shopeeE-commerceLive

Call pattern: POST /v1/ecommerce/shopee/tools/{tool} (11 endpoints)

Endpoint	Input	Note
shopee_category_tree	site:string · node_id:string	Browse the Shopee category tree for one site.
shopee_category_search_from_name	name*:string · site:string	Find Shopee categories by name and get their node ids.
shopee_category_request	node_id*:string · query_date:string · page:integer · site:string	Best-selling products under a Shopee category (sub-categories only).
shopee_category_trend	node_id*:string · trend_index:string · site:string	Historical trend of a Shopee category market.
shopee_product_search	node_id:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · comment_count_min:string · comment_count_max:string · site:string · page:integer	Search Shopee products with filters, sorted by monthly sales.
shopee_product_search_from_name	name*:string · site:string · page:integer	Search Shopee products by name; up to 20 per page.
shopee_product_request	product_id*:string · site:string	Full detail record of a single Shopee product.
shopee_product_trend	product_id*:string · start_date:string · end_date:string · site:string	Historical trend of a Shopee product (star / comments / price / sales).
shopee_keyword_search	keyword:string · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string · site:string · page:integer	Trending keywords on Shopee, by monthly search volume.
shopee_keyword_relation_results	keyword*:string · site:string · page:integer	Products related to a Shopee keyword, up to 20 per page.
shopee_shop_request	shop_id*:string · site:string	Shopee seller profile plus a top-500 snapshot of its products.

temuE-commerceLive

Call pattern: POST /v1/ecommerce/temu/tools/{tool} (7 endpoints)

Endpoint	Input	Note
temu_category_tree	site:string · node_id:string	Browse the Temu category tree for one site.
temu_category_search_from_name	name*:string · site:string	Find Temu categories by name and get their node ids.
temu_category_request	node_id*:string · page:integer · site:string	Best-selling products under a Temu category.
temu_product_search	node_id:string · brand:string · seller_name:string · price_min:string · price_max:string · sales_min:string · sales_max:string · star_min:string · star_max:string · comment_count_min:string · comment_count_max:string · site:string · page:integer	Search Temu products with filters, sorted by monthly sales.
temu_product_search_from_name	name*:string · site:string · page:integer	Search Temu products by name; 20 per page.
temu_product_request	product_id*:string · site:string	Full detail record of a single Temu product.
temu_product_trend	product_id*:string · start_date:string · end_date:string · site:string	Historical trend of a Temu product (sales / price / comments / star).

tiktokSocialLive

Call pattern: POST /v1/social/tiktok/tools/{tool} (4 endpoints)

Endpoint	Input	Note
tiktok_user_profile	username:string · user_id:string	Public profile of a TikTok account.
tiktok_user_posts	user_id*:string · cursor:string · count:integer	Videos published by a TikTok account, newest first.
tiktok_post_detail	post_id*:string · region:string	Single TikTok video with its author and engagement counters.
tiktok_post_comments	post_id*:string · cursor:string · count:integer	Top-level comments of a TikTok video.

tiktokshopE-commerceLive

Call pattern: POST /v1/ecommerce/tiktokshop/tools/{tool} (10 endpoints)

Endpoint	Input	Note
tiktok_category_tree	site:string · node_id:string	Browse the TikTok Shop category tree for one site.
tiktok_category_search_from_name	name*:string · site:string	Find TikTok Shop categories by name and get their node ids.
tiktok_category_request	node_id*:string · page:integer · site:string	Best-selling products under a TikTok Shop category.
tiktok_category_trend	node_id*:string · trend_index:string · site:string	Historical trend of a TikTok Shop category market.
tiktok_product_search	node_id:string · brand:string · seller_name:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · review_count_min:string · review_count_max:string · site:string · page:integer	Search TikTok Shop products with filters.
tiktok_product_search_from_name	name*:string · site:string · page:integer	Search TikTok Shop products by name.
tiktok_product_request	product_id*:string · site:string	Full detail record of a single TikTok Shop product.
tiktok_product_trend	product_id*:string · trend_type:string · site:string	Historical trend of a TikTok Shop product.
tiktok_shop_request	shop_id*:string · site:string	TikTok Shop seller details.
tiktok_shop_search	node_id:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · site:string · page:integer	Search TikTok Shop sellers with filters.

walmartE-commerceLive

Call pattern: POST /v1/ecommerce/walmart/tools/{tool} (12 endpoints)

Endpoint	Input	Note
walmart_category_tree	node_id:string	Browse the Walmart category tree (US site only).
walmart_category_search_from_name	name*:string	Find Walmart categories by name and get their node ids.
walmart_category_report_by_node_id	node_id*:string	Real-time top-100 best sellers of a Walmart category.
walmart_product_search_from_name	name*:string · page:integer	Search Walmart products by name; up to 20 per page.
walmart_product_detail_by_product_id	product_id*:string	Full detail record of a single Walmart product.
walmart_product_trend_by_product_id	product_id*:string · trend_type:string · start_date:string · end_date:string	Historical trend of a Walmart product (sales volume / amount and more).
walmart_product_variation_sales_by_product_id	product_id*:string · start_date:string · end_date:string · page:integer	Child-item sales breakdown of a Walmart product.
walmart_product_traffic_terms	product_id*:string · page:integer	Keywords a Walmart product has recently been exposed under.
walmart_keyword_list	rank_min:integer · rank_max:integer · page:integer	Real-time hot keyword list for Walmart, by monthly search volume.
walmart_keyword_detail	keyword*:string	Detail record of one Walmart hot keyword.
walmart_keyword_extends	keyword*:string · page:integer	Extended keywords derived from a Walmart hot keyword.
walmart_keyword_search_results	keyword*:string · page:integer	Natural-position product list for a Walmart hot keyword.

xSocialLive

Call pattern: POST /v1/social/x/tools/{tool} (4 endpoints)

Endpoint	Input	Note
x_user_profile	username:string · user_id:integer	Public profile of an X account.
x_user_posts	username:string · user_id:integer · cursor:string	Posts published by an X account.
x_post_detail	post_id*:string	Single X post with its author and counters.
x_search_posts	query*:string · cursor:string	Keyword search over X posts.

xiaohongshuSocialLive

Call pattern: POST /v1/social/xiaohongshu/tools/{tool} (4 endpoints)

Endpoint	Input	Note
xiaohongshu_search_notes	query*:string · page:integer · sort_type:string · note_type:string · time_filter:string	Keyword search over Xiaohongshu notes.
xiaohongshu_user_profile	user_id:string · url:string	Public profile of a Xiaohongshu account.
xiaohongshu_user_notes	user_id:string · url:string · cursor:string	Notes published by a Xiaohongshu account.
xiaohongshu_note_detail	note_id:string · url:string	Single Xiaohongshu note (image or video).

youtubeSocialLive

Call pattern: POST /v1/social/youtube/tools/{tool} (4 endpoints)

Endpoint	Input	Note
youtube_video_detail	video_id*:string	Single YouTube video with description and counters.
youtube_channel_profile	channel_id*:string	Public profile of a YouTube channel.
youtube_channel_videos	channel_id*:string · cursor:string	Videos published by a YouTube channel.
youtube_search_videos	query*:string · cursor:string · order_by:string	Keyword search over YouTube videos.

§06

Data plane

MCP and REST are two interfaces to the same tools; either one uses the same schema.

Item	Value
REST data access	POST https://claudebaby.cn/v1/{domain}/{platform}/tools/{tool}
REST endpoint catalog	https://claudebaby.cn/v1/{domain}/{platform}/tools
MCP（Streamable HTTP）	https://claudebaby.cn/mcp/{platform}
MCP（SSE）	https://claudebaby.cn/sse/{platform}
MCP（stdio）	Local bridge: claudebaby-mcp
Request correlation	Every response includes X-Request-Id
envelope	MCP structuredContent matches the REST response byte for byte

§07

Account self-check

API	Returns
GET /api/me	Account · plan · current-period quota · balance · balance level
GET /api/usage?groupBy=platform\|day\|endpoint	Calls · credits · success / failure rate

These APIs also use API-key authentication. Balance, quota, and failure rate are fully visible to customers—this is a product commitment, not a best-effort feature.

§08

Error codes

code	HTTP	Guidance	message
invalid_request	400	Do not retry	The request parameters are invalid.
unauthorized	401	Do not retry	Missing or invalid API key.
insufficient_balance	402	Do not retry	Account balance is insufficient for this request.
data_source_disabled	403	Do not retry	This data source is disabled in your workspace.
not_found	404	Do not retry	The requested resource does not exist.
rate_limited	429	Retryable	Rate limit exceeded for this plan, please retry later.
job_not_ready	409	Retryable	The job is still running.
upstream_unavailable	503	Retryable	The data source is temporarily unavailable.
upstream_timeout	504	Retryable	The data source did not respond in time.
capacity_exceeded	503	Do not retry	Service capacity is saturated, please retry later.
internal_error	500	Retryable	An internal error occurred.

The error body is always {"error": {"code", "message", "retryable", "details"}}; rate limits and upstream failures include Retry-After.