# claudebaby

> Agent 友好的数据站：多源数据封装成按平台拆分的 MCP 服务与统一 REST API。
> 客户只看到平台与端点，原始数据源不对外暴露。

## 接入

- REST 基址：https://claudebaby.cn/v1/{domain}/{platform}/{endpoint}
- MCP（Streamable HTTP）：https://claudebaby.cn/mcp/{platform}
- MCP（SSE）：https://claudebaby.cn/sse/{platform}
- MCP（stdio）：`claudebaby-mcp --platform <platform>`，本地不落上游密钥
- 鉴权：`Authorization: Bearer <API Key>`（或 `X-API-Key`）

## 机器可读入口

- MCP 清单：https://claudebaby.cn/.well-known/mcp.json
- OpenAPI（含错误码表）：https://claudebaby.cn/openapi.json
- 价目表（含积分系数）：https://claudebaby.cn/pricing.json
- 平台清单：https://claudebaby.cn/v1/meta/platforms

## 自助链路（全自动，无人工）

1. 注册：https://claudebaby.cn/console/register
2. 实名：https://claudebaby.cn/console/realname
3. 发 Key：控制台「API Key」页，明文只展示一次
4. 充值：https://claudebaby.cn/console/recharge
5. 调用：用量与余额可自查 `/console/api/overview`

## 计费口径

- 1 积分 = ¥0.02 = 50 积分/元；最低计费单位 1 积分/次。
- 单次扣减 = max(1 积分, 积分系数 × 数量)；系数按档位公开在价目表里。
- 预付费，无订阅费；余额不足返回 `insufficient_balance`（HTTP 402）。

## 错误码（Agent 据此重试 / 降级）

- `invalid_request` · HTTP 400 · 不可重试 · The request parameters are invalid.
- `unauthorized` · HTTP 401 · 不可重试 · Missing or invalid API key.
- `insufficient_balance` · HTTP 402 · 不可重试 · Account balance is insufficient for this request.
- `not_found` · HTTP 404 · 不可重试 · The requested resource does not exist.
- `rate_limited` · HTTP 429 · 可重试 · Rate limit exceeded for this plan, please retry later.
- `job_not_ready` · HTTP 409 · 可重试 · The job is still running.
- `upstream_unavailable` · HTTP 503 · 可重试 · The data source is temporarily unavailable.
- `upstream_timeout` · HTTP 504 · 可重试 · The data source did not respond in time.
- `capacity_exceeded` · HTTP 503 · 不可重试 · Service capacity is saturated, please retry later.
- `internal_error` · HTTP 500 · 可重试 · An internal error occurred.

## 平台（已上线）

- bilibili（社媒）：https://claudebaby.cn/v1/social/bilibili
- douyin（社媒）：https://claudebaby.cn/v1/social/douyin
- gongzhonghao（社媒）：https://claudebaby.cn/v1/social/gongzhonghao
- instagram（社媒）：https://claudebaby.cn/v1/social/instagram
- kuaishou（社媒）：https://claudebaby.cn/v1/social/kuaishou
- lemon8（社媒）：https://claudebaby.cn/v1/social/lemon8
- linkedin（社媒）：https://claudebaby.cn/v1/social/linkedin
- reddit（社媒）：https://claudebaby.cn/v1/social/reddit
- threads（社媒）：https://claudebaby.cn/v1/social/threads
- tiktok（社媒）：https://claudebaby.cn/v1/social/tiktok
- toutiao（社媒）：https://claudebaby.cn/v1/social/toutiao
- weibo（社媒）：https://claudebaby.cn/v1/social/weibo
- x（社媒）：https://claudebaby.cn/v1/social/x
- xiaohongshu（社媒）：https://claudebaby.cn/v1/social/xiaohongshu
- xigua（社媒）：https://claudebaby.cn/v1/social/xigua
- youtube（社媒）：https://claudebaby.cn/v1/social/youtube
- zhihu（社媒）：https://claudebaby.cn/v1/social/zhihu

## 平台（规划中，暂不对外挂载）

1688, amazon, shopee, temu, tiktokshop, walmart