ClaudeBaby

通过 MCP 和 REST API 为 AI Agent 提供社媒与电商平台数据,支持跨平台商品研究。

Hosted MCP Server

npx add-mcp 'https://claudebaby.cn/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

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.

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.

Log in to the console and refresh this page to get your personal connection link. Rotate credential now →

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 Log in to get an MCP-only credential

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

01

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.

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"
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 →

02

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 mcp add --scope user --transport http claudebaby https://claudebaby.cn/mcp --header "Authorization: Bearer $CB_KEY"

See Advanced / compatibility options below for other clients.

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

02 Remote Streamable HTTP / SSE Compatibility

Agent / MCP Client Clients with remote MCP support

claudebaby.cn cloud gateway Aggregate-router MCP / platform MCP

Remote compatibility endpoint No 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.

  1. Sign up Open Console and create an account with your email and password.
  2. 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.
  3. 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.
  4. 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.
# 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
{
  "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
# 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

Endpoint https://claudebaby.cn/mcp

Server Transport HTTP Streamable

Tools to Include All

  1. Create or open an AI Agent workflow
  2. Add an MCP Client / MCP Server node
  3. Paste the URL, choose HTTP Streamable, and load all tools
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 point Expert → Choose connector → Custom connector

Type Streamable HTTP

URL https://claudebaby.cn/mcp

Status Connected · choose tools

  1. Open the expert panel and choose custom connector
  2. Click configure and paste the JSON
  3. Save, return to the MCP list, and enable claudebaby
{
  "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

Settings MCP → Add server

Name claudebaby

Transport Streamable HTTP

URL https://claudebaby.cn/mcp

  1. Open MCP servers in Codex settings
  2. Add claudebaby and choose Streamable HTTP
  3. Save and verify with codex mcp list
# 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 Code claude mcp add

Transport HTTP / Streamable HTTP

Server claudebaby

Verify /mcp or claude mcp list

  1. Run the command in Claude Code, or open Customize in Desktop
  2. Add a remote MCP server and paste the URL
  3. Run /mcp in a session and confirm the tools appear
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)

PlatformMarket / domainMCP(Streamable HTTP)MCP(SSE)stdio
1688Domestic · e-commercehttps://claudebaby.cn/mcp/1688https://claudebaby.cn/sse/1688claudebaby-mcp --platform 1688
amazonInternational · e-commercehttps://claudebaby.cn/mcp/amazonhttps://claudebaby.cn/sse/amazonclaudebaby-mcp --platform amazon
douyinDomestic · socialhttps://claudebaby.cn/mcp/douyinhttps://claudebaby.cn/sse/douyinclaudebaby-mcp --platform douyin
facebookInternational · socialhttps://claudebaby.cn/mcp/facebookhttps://claudebaby.cn/sse/facebookclaudebaby-mcp --platform facebook
linkedinInternational · socialhttps://claudebaby.cn/mcp/linkedinhttps://claudebaby.cn/sse/linkedinclaudebaby-mcp --platform linkedin
redditInternational · socialhttps://claudebaby.cn/mcp/reddithttps://claudebaby.cn/sse/redditclaudebaby-mcp --platform reddit
shopeeInternational · e-commercehttps://claudebaby.cn/mcp/shopeehttps://claudebaby.cn/sse/shopeeclaudebaby-mcp --platform shopee
temuInternational · e-commercehttps://claudebaby.cn/mcp/temuhttps://claudebaby.cn/sse/temuclaudebaby-mcp --platform temu
tiktokInternational · socialhttps://claudebaby.cn/mcp/tiktokhttps://claudebaby.cn/sse/tiktokclaudebaby-mcp --platform tiktok
tiktokshopInternational · e-commercehttps://claudebaby.cn/mcp/tiktokshophttps://claudebaby.cn/sse/tiktokshopclaudebaby-mcp --platform tiktokshop
walmartInternational · e-commercehttps://claudebaby.cn/mcp/walmarthttps://claudebaby.cn/sse/walmartclaudebaby-mcp --platform walmart
xInternational · socialhttps://claudebaby.cn/mcp/xhttps://claudebaby.cn/sse/xclaudebaby-mcp --platform x
xiaohongshuDomestic · socialhttps://claudebaby.cn/mcp/xiaohongshuhttps://claudebaby.cn/sse/xiaohongshuclaudebaby-mcp --platform xiaohongshu
youtubeInternational · socialhttps://claudebaby.cn/mcp/youtubehttps://claudebaby.cn/sse/youtubeclaudebaby-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

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 pointContentPurpose
/.well-known/mcp.jsonPlatform catalog + MCP endpoint for each platformDiscover and mount automatically
/openapi.jsonData-plane OpenAPI 3.1 + error-code catalogGenerate clients / validate the contract
/pricing.jsonPlans · top-up pricing · credit factors · per-platform pricingCalculate cost before calling
/llms.txtPlain-text site indexReadable by agents without HTML
/api/me · /api/usageBalance / quota / failure rateSelf-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)

EndpointInputNote
ali1688_category_treenode_id:stringBrowse the 1688 category tree.
ali1688_product_searchnode_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:integerSearch 1688 offers / suppliers with multi-dimensional filters.
ali1688_product_requestproduct_id*:stringFull detail record of a single 1688 offer.
ali1688_product_variationsproduct_id*:stringSKU / variation data of a 1688 offer.
ali1688_similar_productsearch_name*:string · page:integerSourcing / wholesale suppliers for a product name — procurement cost view.

amazonE-commerceLive

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

EndpointInputNote
category_treesite:string · node_id:stringBrowse the Amazon category tree; omit node_id for the top two levels.
category_name_searchname*:string · site:stringFind Amazon sub-categories by name and get their node ids.
category_reportnode_id*:string · site:stringTop-100 best sellers of an Amazon sub-category, real time.
category_report_from_historynode_id*:string · start_date*:string · end_date*:string · site:stringTop-100 best sellers of an Amazon sub-category in a past date range.
category_trendnode_id*:string · trend_index:string · site:stringHistorical trend of an Amazon sub-category market.
category_keywordsnode_id*:string · page:integer · site:stringCore keywords of an Amazon sub-category market.
product_searchsearch_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:stringSearch live Amazon products with multi-dimensional filters.
product_search_from_namename*:string · page:integer · site:stringSearch Amazon products by name; up to 20 per page.
product_detailasin*:string · site:stringFull detail record of a single Amazon product (one ASIN per call).
product_trendasin*:string · trend_type:string · site:stringHistorical trend of an Amazon product (sales / price / rank).
product_reviewsasin*:string · review_type:string · site:stringUp to 100 Amazon user reviews of a product from the last year.
product_customers_sayasin*:string · site:stringAmazon `Customers Say` summary distilled from a product's reviews.
product_variationsasin*:string · page:integer · site:stringChild-ASIN variation breakdown of an Amazon parent product.
product_traffic_termsasin*:string · page:integer · site:stringKeywords an Amazon product has recently been exposed under.
product_ranking_trend_by_keywordasin*:string · keyword*:string · page:integer · site:stringExposure-ranking trend of an Amazon product under one keyword.
keyword_listsite:string · page:integer · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:stringLive trending keyword list for an Amazon site, by weekly search volume.
keyword_detailkeyword*:string · site:stringDetail record of one trending Amazon keyword.
keyword_trendkeyword*:string · site:stringHistorical trend of an Amazon keyword (volume / rank / CPC).
keyword_extendskeyword*:string · site:string · page:integerExtended / long-tail keywords derived from an Amazon keyword.
keyword_search_resultskeyword*:string · site:string · page:integer · position_type:stringProducts holding organic positions for an Amazon keyword.

douyinSocialLive

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

EndpointInputNote
douyin_user_profileusername*:stringPublic profile of a Douyin account.
douyin_post_detailpost_id*:stringSingle Douyin video with its author and counters.
douyin_post_commentspost_id*:string · cursor:string · count:integerTop-level comments of a Douyin video.
douyin_search_videosquery*:string · cursor:string · sort_type:string · publish_time:stringKeyword search over Douyin videos.

facebookSocialLive

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

EndpointInputNote
facebook_page_profileurl*:stringFetch a public Facebook page profile.
facebook_page_postsurl*:string · limit:integerFetch recent public posts from a Facebook page.
facebook_post_detailurl*:stringFetch a public Facebook post and its engagement data.

linkedinSocialLive

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

EndpointInputNote
linkedin_user_profileurl*:stringPublic profile of a LinkedIn member.
linkedin_company_profileurl*:stringPublic page of a LinkedIn company.
linkedin_post_detailurl*:stringSingle LinkedIn post or article.

redditSocialLive

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

EndpointInputNote
reddit_search_postssubreddit*:string · query*:string · days:integer · limit:integerSearch 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_threadpost_id*:string · top_n:integerFetch the comment tree of a single post, optionally only the top N.
reddit_search_commentssubreddit*:string · query*:string · days:integer · limit:integerSearch 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)

EndpointInputNote
shopee_category_treesite:string · node_id:stringBrowse the Shopee category tree for one site.
shopee_category_search_from_namename*:string · site:stringFind Shopee categories by name and get their node ids.
shopee_category_requestnode_id*:string · query_date:string · page:integer · site:stringBest-selling products under a Shopee category (sub-categories only).
shopee_category_trendnode_id*:string · trend_index:string · site:stringHistorical trend of a Shopee category market.
shopee_product_searchnode_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:integerSearch Shopee products with filters, sorted by monthly sales.
shopee_product_search_from_namename*:string · site:string · page:integerSearch Shopee products by name; up to 20 per page.
shopee_product_requestproduct_id*:string · site:stringFull detail record of a single Shopee product.
shopee_product_trendproduct_id*:string · start_date:string · end_date:string · site:stringHistorical trend of a Shopee product (star / comments / price / sales).
shopee_keyword_searchkeyword:string · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string · site:string · page:integerTrending keywords on Shopee, by monthly search volume.
shopee_keyword_relation_resultskeyword*:string · site:string · page:integerProducts related to a Shopee keyword, up to 20 per page.
shopee_shop_requestshop_id*:string · site:stringShopee seller profile plus a top-500 snapshot of its products.

temuE-commerceLive

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

EndpointInputNote
temu_category_treesite:string · node_id:stringBrowse the Temu category tree for one site.
temu_category_search_from_namename*:string · site:stringFind Temu categories by name and get their node ids.
temu_category_requestnode_id*:string · page:integer · site:stringBest-selling products under a Temu category.
temu_product_searchnode_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:integerSearch Temu products with filters, sorted by monthly sales.
temu_product_search_from_namename*:string · site:string · page:integerSearch Temu products by name; 20 per page.
temu_product_requestproduct_id*:string · site:stringFull detail record of a single Temu product.
temu_product_trendproduct_id*:string · start_date:string · end_date:string · site:stringHistorical trend of a Temu product (sales / price / comments / star).

tiktokSocialLive

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

EndpointInputNote
tiktok_user_profileusername:string · user_id:stringPublic profile of a TikTok account.
tiktok_user_postsuser_id*:string · cursor:string · count:integerVideos published by a TikTok account, newest first.
tiktok_post_detailpost_id*:string · region:stringSingle TikTok video with its author and engagement counters.
tiktok_post_commentspost_id*:string · cursor:string · count:integerTop-level comments of a TikTok video.

tiktokshopE-commerceLive

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

EndpointInputNote
tiktok_category_treesite:string · node_id:stringBrowse the TikTok Shop category tree for one site.
tiktok_category_search_from_namename*:string · site:stringFind TikTok Shop categories by name and get their node ids.
tiktok_category_requestnode_id*:string · page:integer · site:stringBest-selling products under a TikTok Shop category.
tiktok_category_trendnode_id*:string · trend_index:string · site:stringHistorical trend of a TikTok Shop category market.
tiktok_product_searchnode_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:integerSearch TikTok Shop products with filters.
tiktok_product_search_from_namename*:string · site:string · page:integerSearch TikTok Shop products by name.
tiktok_product_requestproduct_id*:string · site:stringFull detail record of a single TikTok Shop product.
tiktok_product_trendproduct_id*:string · trend_type:string · site:stringHistorical trend of a TikTok Shop product.
tiktok_shop_requestshop_id*:string · site:stringTikTok Shop seller details.
tiktok_shop_searchnode_id:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · site:string · page:integerSearch TikTok Shop sellers with filters.

walmartE-commerceLive

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

EndpointInputNote
walmart_category_treenode_id:stringBrowse the Walmart category tree (US site only).
walmart_category_search_from_namename*:stringFind Walmart categories by name and get their node ids.
walmart_category_report_by_node_idnode_id*:stringReal-time top-100 best sellers of a Walmart category.
walmart_product_search_from_namename*:string · page:integerSearch Walmart products by name; up to 20 per page.
walmart_product_detail_by_product_idproduct_id*:stringFull detail record of a single Walmart product.
walmart_product_trend_by_product_idproduct_id*:string · trend_type:string · start_date:string · end_date:stringHistorical trend of a Walmart product (sales volume / amount and more).
walmart_product_variation_sales_by_product_idproduct_id*:string · start_date:string · end_date:string · page:integerChild-item sales breakdown of a Walmart product.
walmart_product_traffic_termsproduct_id*:string · page:integerKeywords a Walmart product has recently been exposed under.
walmart_keyword_listrank_min*:integer · rank_max*:integer · page:integerReal-time hot keyword list for Walmart, by monthly search volume.
walmart_keyword_detailkeyword*:stringDetail record of one Walmart hot keyword.
walmart_keyword_extendskeyword*:string · page:integerExtended keywords derived from a Walmart hot keyword.
walmart_keyword_search_resultskeyword*:string · page:integerNatural-position product list for a Walmart hot keyword.

xSocialLive

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

EndpointInputNote
x_user_profileusername:string · user_id:integerPublic profile of an X account.
x_user_postsusername:string · user_id:integer · cursor:stringPosts published by an X account.
x_post_detailpost_id*:stringSingle X post with its author and counters.
x_search_postsquery*:string · cursor:stringKeyword search over X posts.

xiaohongshuSocialLive

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

EndpointInputNote
xiaohongshu_search_notesquery*:string · page:integer · sort_type:string · note_type:string · time_filter:stringKeyword search over Xiaohongshu notes.
xiaohongshu_user_profileuser_id:string · url:stringPublic profile of a Xiaohongshu account.
xiaohongshu_user_notesuser_id:string · url:string · cursor:stringNotes published by a Xiaohongshu account.
xiaohongshu_note_detailnote_id:string · url:stringSingle Xiaohongshu note (image or video).

youtubeSocialLive

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

EndpointInputNote
youtube_video_detailvideo_id*:stringSingle YouTube video with description and counters.
youtube_channel_profilechannel_id*:stringPublic profile of a YouTube channel.
youtube_channel_videoschannel_id*:string · cursor:stringVideos published by a YouTube channel.
youtube_search_videosquery*:string · cursor:string · order_by:stringKeyword search over YouTube videos.

§06

Data plane

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

ItemValue
REST data accessPOST https://claudebaby.cn/v1/{domain}/{platform}/tools/{tool}
REST endpoint cataloghttps://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 correlationEvery response includes X-Request-Id
envelopeMCP structuredContent matches the REST response byte for byte

§07

Account self-check

APIReturns
GET /api/meAccount · plan · current-period quota · balance · balance level
GET /api/usage?groupBy=platform|day|endpointCalls · 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

codeHTTPGuidancemessage
invalid_request400Do not retryThe request parameters are invalid.
unauthorized401Do not retryMissing or invalid API key.
insufficient_balance402Do not retryAccount balance is insufficient for this request.
data_source_disabled403Do not retryThis data source is disabled in your workspace.
not_found404Do not retryThe requested resource does not exist.
rate_limited429RetryableRate limit exceeded for this plan, please retry later.
job_not_ready409RetryableThe job is still running.
upstream_unavailable503RetryableThe data source is temporarily unavailable.
upstream_timeout504RetryableThe data source did not respond in time.
capacity_exceeded503Do not retryService capacity is saturated, please retry later.
internal_error500RetryableAn internal error occurred.

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