# MCP 工具列表

SocialToAI 的 MCP 服务在 https://mcp.socialtoai.com/mcp 上列出 16 个工具。每个都是只读的，描述里写明用途和积分，你的 AI 据此判断什么时候用、要花多少。失败的调用不扣，每次返回都写明扣了多少、还剩多少。

- 页面：https://socialtoai.com/zh/docs/mcp/tools/
- 最近更新：2026-10-17

怎么接入客户端见 [MCP 页](https://socialtoai.com/zh/mcp.md)。这一页就是服务对 `tools/list` 的回答。

## 工具

| 工具 | 做什么 | 每次调用 |
| --- | --- | --- |
| [`search`](https://socialtoai.com/zh/docs/mcp/tools.md) | 按关键词找内容或账号 | 2–12 积分 |
| [`trending`](https://socialtoai.com/zh/docs/mcp/tools.md) | 现在什么在火 | 2–12 积分 |
| [`detail`](https://socialtoai.com/zh/docs/mcp/tools.md) | 一条内容的正文和数据 | 1–12 积分 |
| [`comments`](https://socialtoai.com/zh/docs/mcp/tools.md) | 一条内容下的评论 | 2–12 积分 |
| [`user_profile`](https://socialtoai.com/zh/docs/mcp/tools.md) | 一个账号的简介和数据 | 1–12 积分 |
| [`user_posts`](https://socialtoai.com/zh/docs/mcp/tools.md) | 一个账号发过的内容 | 2–12 积分 |
| [`find`](https://socialtoai.com/zh/docs/mcp/tools.md) | Find what can be called by what it does, in plain words, English or Chinese | 免费 |
| [`call`](https://socialtoai.com/zh/docs/mcp/tools.md) | Call one platform-specific capability by its op ("platform.name"): what the six actions do not cover | 按实际调用计 |
| [`capabilities`](https://socialtoai.com/zh/docs/mcp/tools.md) | List what can be called now: each action per platform and each op, with its parameters (type, values, default), its credits per call, its page size, the fields it cannot give and a call that works | 免费 |
| [`account`](https://socialtoai.com/zh/docs/mcp/tools.md) | Whose key or connected app this connection is and where it stands: the plan (free or paid), the credit balance, and today's spend, daily limit and room left of the connection and of its account | 免费 |
| [`brand_buzz`](https://socialtoai.com/zh/docs/mcp/tools.md) | What people say about a brand or product on each platform: the share of each attitude, what is mentioned most, and the posts with the most engagement, each with its source link | 按实际调用计 |
| [`comment_insights`](https://socialtoai.com/zh/docs/mcp/tools.md) | What the comments under your posts are about: the topics and their shares, the questions asked, who wants to buy and what is complained about, with the comments quoted | 按实际调用计 |
| [`find_creators`](https://socialtoai.com/zh/docs/mcp/tools.md) | Creators on one platform for a niche: their size, their recent posts, and how well each fits what you asked for, with the reasons | 按实际调用计 |
| [`account_watch`](https://socialtoai.com/zh/docs/mcp/tools.md) | What a set of accounts published lately and which posts did clearly better than each account's usual | 按实际调用计 |
| [`creator_card`](https://socialtoai.com/zh/docs/mcp/tools.md) | One creator across platforms: the accounts found for the same person, with followers, posts, engagement and how strong the evidence is that each is theirs | 按实际调用计 |
| [`research`](https://socialtoai.com/zh/docs/mcp/tools.md) | Run one of these by its name, on our side | 按实际调用计 |

每个计费工具都有 `handle` 参数：凭之前返回的句柄读那个结果，免费，别的什么都不跑。很大的结果会分段返回，每段带着读下一段的句柄。两件事都在[结果与句柄](https://socialtoai.com/zh/docs/api/results.md) 里。

## 逐个工具

### `search` (2–12 积分, 只读)

**你的 AI 拿到的描述**

```
Search a platform for content. Read-only. Each line: what to pass, then its platforms, 2 credits a call unless numbered. A list of platforms is one call each. Failed calls cost 0.
Give query: bilibili, douyin 12, kuaishou 12, linkedin, pinterest, reddit, threads, tiktok, wechat 12, wechat_channels 12, weibo, x, xiaohongshu 12, youtube, zhihu
With type=user: douyin, instagram 3, tiktok, weibo, x 5, xiaohongshu 12, zhihu
With sort=latest: x
With type=image: xiaohongshu 12
Each platform's own parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | One, or a list. |
| `query` | string | 否 | Search terms |
| `sort` | string | 否 | By platform: relevance, latest, popular |
| `published_within` | string | 否 | By platform: day, week, half_year, month, year |
| `type` | string | 否 | Answers only, or articles only; both when left out. By platform: answer, article, user, image |
| `since` | string | 否 | Published on or after this day (filtered by UTC date; the time of day is ignored) |
| `until` | string | 否 | Published on or before this day (filtered by UTC date; the time of day is ignored) |
| `cursor` | string | 否 | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `trending` (2–12 积分, 只读)

**你的 AI 拿到的描述**

```
Read a platform's trending list. Read-only. Each line: what to pass, then its platforms, 2 credits a call unless numbered. A list of platforms is one call each. Failed calls cost 0.
Needs no parameter: bilibili, douyin, kuaishou, reddit, weibo, x 6, xiaohongshu 12, zhihu
With type=videos: bilibili, douyin
With type=trends: reddit
Each platform's own parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | One, or a list. |
| `board` | string | 否 | By platform: hot_search, rising, topics, searches, music, low_fan, high_like, high_completion, high_follow, popular, trends, inspiration, hot |
| `type` | string | 否 | By platform: videos, trends |
| `region` | string | 否 | Which country's trends, by its two-letter code: US, GB, CA, AU, IN, JP, DE, FR, BR or MX; worldwide when left out |
| `cursor` | string | 否 | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `detail` (1–12 积分, 只读)

**你的 AI 拿到的描述**

```
Get one piece of content by its id or link. Read-only. Each line: what to pass (a|b: either one), then its platforms, 2 credits a call unless numbered. A list of platforms, ids or links is one call each. Failed calls cost 0.
Give id|url: bilibili, douyin, instagram, kuaishou, linkedin, pinterest, reddit, telegram, threads, tiktok, x 1, xiaohongshu 12, youtube, zhihu
Give url: facebook, wechat 12
Give id: wechat_channels 12, weibo
With type=article|pin|question: zhihu
Add include=transcript, charged on top: instagram, linkedin, reddit, tiktok, youtube
Each platform's own parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | One, or a list. |
| `id` | string \| array | 否 | 视频编号，一串数字 |
| `url` | string \| array | 否 | 视频的网页链接 |
| `type` | string | 否 | By platform: article, pin, question |
| `include` | string \| array | 否 | Fetched beside each result: transcript. |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `comments` (2–12 积分, 只读)

**你的 AI 拿到的描述**

```
Read the comments under one piece of content. Read-only. Each line: what to pass (a|b: either one), then its platforms, 2 credits a call unless numbered. A list of platforms, ids or links is one call each. Failed calls cost 0.
Give id: bilibili, douyin, facebook, kuaishou, wechat_channels 12, weibo, x, zhihu
Give id|url: instagram, reddit, tiktok, xiaohongshu 12, youtube
Give url: wechat 12
With reply_of: bilibili, douyin, instagram, kuaishou, tiktok, xiaohongshu 12, youtube, zhihu
Each platform's own parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | One, or a list. |
| `id` | string \| array | 否 | 视频编号，一串数字 |
| `reply_of` | string \| array | 否 |  |
| `url` | string \| array | 否 | 视频的网页链接 |
| `sort` | string | 否 | By platform: best, latest, popular |
| `cursor` | string | 否 | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `user_profile` (1–12 积分, 只读)

**你的 AI 拿到的描述**

```
Get one account's public profile: name, bio, verification and follower counts. Read-only. Each line: what to pass (a|b: either one), then its platforms, 2 credits a call unless numbered. A list of platforms is one call each. Failed calls cost 0.
Give id: bilibili, kuaishou 12, wechat 12, wechat_channels 12, weibo
Give id|url: douyin, xiaohongshu 12
Give id|username|url: facebook
Give username: instagram, reddit, telegram, threads, zhihu
Give username|url: linkedin
Give id|username: tiktok, x 1, youtube
Each platform's own parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | One, or a list. |
| `id` | string | 否 | TikTok 用户编号，一串数字 |
| `url` | string | 否 | 主页链接，facebook.com/账号名 的写法 |
| `username` | string | 否 | TikTok 账号名，不带 @ |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `user_posts` (2–12 积分, 只读)

**你的 AI 拿到的描述**

```
List what one account has published. Read-only. Each line: what to pass (a|b: either one), then its platforms, 2 credits a call unless numbered. A list of platforms is one call each. Failed calls cost 0.
Give id: bilibili, douyin, kuaishou 12, wechat 12, wechat_channels 12
Give id|username|url: facebook
Give username: instagram, reddit, telegram, threads, tiktok, x, zhihu
Give username|url: linkedin
Give id|url: xiaohongshu 12
With type=answer|pin: zhihu
Each platform's own parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | One, or a list. |
| `id` | string | 否 | 主页编号，一串数字；比账号名快 |
| `username` | string | 否 | TikTok 账号名，不带 @ |
| `url` | string | 否 | 主页链接，facebook.com/账号名 的写法 |
| `type` | string | 否 | Every post, or reels only. By platform: all, reel, answer, pin |
| `sort` | string | 否 | Newest first, or most popular first. By platform: latest, popular |
| `tab` | string | 否 | Which tab of the profile: posts (retweets among them), replies (with the posts replied to), or media. By platform: posts, replies, media |
| `cursor` | string | 否 | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `find` (免费, 只读)

**你的 AI 拿到的描述**

```
Find what can be called by what it does, in plain words, English or Chinese. Answers the matching actions and ops, best first, each with its parameters, its credits per call and a call that works. Free. Then use the action's tool, or call with the op.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `query` | string | 是 | What it should do, in 1 to 500 characters. |
| `platform` | string | 否 | Only this platform. |
| `limit` | integer | 否 | How many, 1 to 50; 10 unless given. |

### `call` (按实际调用计, 只读)

**你的 AI 拿到的描述**

```
Call one platform-specific capability by its op ("platform.name"): what the six actions do not cover. find finds an op by what it does; capabilities lists each with its parameters and its credits per call (1 to 24). Read-only. A failed call costs 0.
Ops per platform now: douyin 24, google 3, instagram 1, linkedin 2, meta 4, reddit 3, tiktok 10, wechat 1, wechat_channels 2, weibo 2, x 12, xiaohongshu 5, youtube 2, zhihu 3.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `op` | string | 是 | As find and capabilities give it, like douyin.account_audience. |
| `params` | object | 否 | The op's own parameters, by name. |
| `cursor` | string | 否 | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | 否 | Refused, free, if the call would cost more. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `capabilities` (免费, 只读)

**你的 AI 拿到的描述**

```
List what can be called now: each action per platform and each op, with its parameters (type, values, default), its credits per call, its page size, the fields it cannot give and a call that works. Free. The whole list is long: pass platform.
Platforms now: bilibili, douyin, facebook, google, instagram, kuaishou, linkedin, meta, pinterest, reddit, telegram, threads, tiktok, wechat, wechat_channels, weibo, x, xiaohongshu, youtube, zhihu.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string | 否 | Only this platform. |

### `account` (免费, 只读)

**你的 AI 拿到的描述**

```
Whose key or connected app this connection is and where it stands: the plan (free or paid), the credit balance, and today's spend, daily limit and room left of the connection and of its account. Free.
```

### `brand_buzz` (按实际调用计)

**你的 AI 拿到的描述**

```
What people say about a brand or product on each platform: the share of each attitude, what is mentioned most, and the posts with the most engagement, each with its source link. Runs on our side. A costly or background run answers its price first.
Credits by scale small/medium/large, for one name on one platform: bilibili, youtube 16/100/284; douyin 60/180/420; kuaishou 60/210/540; reddit 20/76/210; wechat 36/270/834; weibo 20/100/282; x 16/124/368; xiaohongshu 36/258/780; zhihu 18/90/234; instagram 16/92/254; linkedin 20/-/-; threads, pinterest 16/-/-; tiktok 16/140/440; wechat_channels 60/306/906.
On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `brand` | string | 是 | The brand, product or topic by its name. |
| `about` | string | 否 | What it is, in a sentence: keeps out other things of the same name. |
| `compare_with` | array | 否 | Up to 2 competitors. Each is read by the same plan and priced on its own. |
| `platforms` | array | 否 | 1 to 5 platforms. Left out: the usual three for the language the name is written in, as far as each is offered; the answer names them. |
| `window` | string | 否 | How far back to read. One of 7d, 30d, 90d. |
| `scale` | string | 否 | small reads up to 40 posts a platform and no comments; medium about 100 posts and 2 pages of comments of 6 of them; large about 200 posts and 3 pages of comments of 15. |
| `max_cost_credits` | integer | 否 | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | 否 | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `comment_insights` (按实际调用计)

**你的 AI 拿到的描述**

```
What the comments under your posts are about: the topics and their shares, the questions asked, who wants to buy and what is complained about, with the comments quoted. Runs on our side. A costly or background run answers its price first.
Credits by scale small/medium/large, for one post: bilibili, douyin, weibo, youtube 50/232/672; kuaishou 40/182/522; reddit 80/382/1122; wechat 150/732/-; x 42/190/544; xiaohongshu 270/672/-; zhihu, facebook 70/332/972; instagram 58/266/772; tiktok 38/172/492; wechat_channels 138/636/-.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `targets` | array | 是 | 1 to 20 links to posts; they may be of different platforms. |
| `focus` | string | 否 | What you want to know, in a sentence: adds the comments that speak to it. |
| `topics` | array | 否 | Your own topics, up to 10: the step that finds topics is then left out. |
| `scale` | string | 否 | The most comments read in all, shared by the posts: small 200, medium 1,000, large 3,000; fewer on a platform whose comments cost more, as the answer says. |
| `max_cost_credits` | integer | 否 | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | 否 | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `find_creators` (按实际调用计)

**你的 AI 拿到的描述**

```
Creators on one platform for a niche: their size, their recent posts, and how well each fits what you asked for, with the reasons. Runs on our side. A costly or background run answers its price first.
Credits by scale small/medium/large, for one search on one platform: bilibili 90/226/442; douyin 9/27/75; x 75/181/347; instagram 93/229/445; tiktok 92/228/444.
On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `query` | string | 是 | The niche, as keywords. |
| `platform` | string | 是 | One platform. |
| `followers_min` | integer | 否 | The fewest followers a creator may have. |
| `followers_max` | integer | 否 | The most followers a creator may have. |
| `brief` | string | 否 | Who you are looking for, in a sentence: what each creator is judged against. |
| `scale` | string | 否 | Creators whose profile and posts are fetched: small 20, medium 50, large 100. |
| `max_cost_credits` | integer | 否 | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | 否 | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `account_watch` (按实际调用计)

**你的 AI 拿到的描述**

```
What a set of accounts published lately and which posts did clearly better than each account's usual. Runs on our side. A costly or background run answers its price first.
Credits by scale small/medium/large, for one account: bilibili 10/12/22; douyin, reddit, zhihu 10/14/24; kuaishou 30/54/70; wechat 42/90/120; x 9/13/29; xiaohongshu 30/54/84; facebook 12/20/30; instagram 12/18/28; linkedin 12/20/-; telegram 10/14/-; threads 12/16/-; tiktok 12/20/36; wechat_channels 42/66/96.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `accounts` | array | 是 | 1 to 20 links to account pages; they may be of different platforms. |
| `window` | string | 否 | How far back to look for new posts. One of 7d, 30d. |
| `scale` | string | 否 | Per account: small about 20 posts, medium about 60, large as medium and the comments of 2 posts that took off. |
| `max_cost_credits` | integer | 否 | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | 否 | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `creator_card` (按实际调用计)

**你的 AI 拿到的描述**

```
One creator across platforms: the accounts found for the same person, with followers, posts, engagement and how strong the evidence is that each is theirs. Runs on our side. A costly or background run answers its price first.
Credits by scale small/medium, for one creator, starting on this platform, looked for on the default platforms: bilibili, x 22/46; douyin 14/38; kuaishou 46/76; reddit, facebook 35/47; wechat, wechat_channels 46/100; xiaohongshu 46/-; zhihu 26/44; instagram 22/34; linkedin, telegram, threads 35/-; tiktok 35/59.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `creator` | string | 是 | A link to the creator's page. |
| `platforms` | array | 否 | The other platforms to look on: up to 3, or 6 with scale medium. Left out: the usual three for the platform the creator starts on, as far as each is offered; the answer names them. |
| `scale` | string | 否 | medium adds a sample of the comments under the creator's latest posts and, where the platform has one, the creator's marketplace profile. |
| `max_cost_credits` | integer | 否 | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | 否 | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |

### `research` (按实际调用计)

**你的 AI 拿到的描述**

```
Run one of these by its name, on our side. A costly or background run answers its price first. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
batch_stats (Bulk link data): urls, max_cost_credits?, confirm?. Credits a link, post/account: bilibili, douyin, reddit, weibo, youtube, zhihu, facebook, instagram, linkedin, telegram, threads, tiktok 2/2; kuaishou 2/12; wechat 24/12; x 1/1; xiaohongshu, wechat_channels 12/12.
viral_finder (Viral finder): query, platform, window?, scale?, max_cost_credits?, confirm?. Credits by scale small/medium/large: bilibili 24/64/160; douyin 48/88/192; x 24/54/130; xiaohongshu 54/294/810; youtube 24/-/-; tiktok 36/76/178.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `tool` | string | 是 | One of batch_stats, viral_finder. |
| `inputs` | object | 是 | That tool's inputs, by name. |
| `handle` | string | 否 | A handle an earlier answer gave: reads that result, free. Nothing else is run. |