---
title: "社媒 MCP 工具清单：18 个工具和参数 · SocialToAI"
canonical: https://socialtoai.app/zh/docs/mcp/tools/
updated: 2026-11-20
---

# MCP 工具列表

SocialToAI 的 MCP 服务在 https://socialtoai.app/mcp 上列出 18 个工具。读数据的工具都是只读的（`watch` 用来新建、暂停、删除你自己的监控），描述里写明用途和积分，你的 AI 据此判断什么时候用、要花多少。失败的调用不扣，每次返回都写明扣了多少、还剩多少。

- 页面：https://socialtoai.app/zh/docs/mcp/tools/
- 最近更新：2026-11-20

下面是 AI 客户端接上 SocialToAI [社媒 MCP 服务器](https://socialtoai.app/zh/mcp.md) 之后看到的工具。其中六个是各平台通用的动作（搜索、热榜、详情、评论、账号资料、账号内容）；其余的用来查找和调用其他接口、运行现成工具、设监控和查余额。AI 读下面每个工具的描述，自己挑工具，所以你用大白话问就行，不用点名工具。这一页就是服务对 `tools/list` 的回答，每个参数都是 AI 拿到的原文。怎么接 Claude、ChatGPT、Cursor 等客户端，见 [MCP 页](https://socialtoai.app/zh/mcp.md)。

这些工具在单个平台上能读什么：[TikTok MCP](https://socialtoai.app/zh/mcp/tiktok.md)、[Instagram MCP](https://socialtoai.app/zh/mcp/instagram.md)、[X MCP](https://socialtoai.app/zh/mcp/x.md)、[Reddit MCP](https://socialtoai.app/zh/mcp/reddit.md)、[YouTube MCP](https://socialtoai.app/zh/mcp/youtube.md)、[Facebook MCP](https://socialtoai.app/zh/mcp/facebook.md)、[LinkedIn MCP](https://socialtoai.app/zh/mcp/linkedin.md)、[Threads MCP](https://socialtoai.app/zh/mcp/threads.md)、[Telegram MCP](https://socialtoai.app/zh/mcp/telegram.md)、[Pinterest MCP](https://socialtoai.app/zh/mcp/pinterest.md)、[小红书 MCP](https://socialtoai.app/zh/mcp/xiaohongshu.md)、[抖音 MCP](https://socialtoai.app/zh/mcp/douyin.md)、[微博 MCP](https://socialtoai.app/zh/mcp/weibo.md)、[公众号 MCP](https://socialtoai.app/zh/mcp/wechat.md)、[B 站 MCP](https://socialtoai.app/zh/mcp/bilibili.md)、[知乎 MCP](https://socialtoai.app/zh/mcp/zhihu.md)、[快手 MCP](https://socialtoai.app/zh/mcp/kuaishou.md)、[视频号 MCP](https://socialtoai.app/zh/mcp/wechat-channels.md)。

`watch` 和 `watch_news` 让你的 AI 替你盯着：一次搜索或一个工具每天或每周再跑一次，只交付新内容。见[定期运行](https://socialtoai.app/zh/docs/schedules.md)。

## 工具

| 工具 | 做什么 | 每次调用 |
| --- | --- | --- |
| [`search`](https://socialtoai.app/zh/docs/mcp/tools.md) | 按关键词找内容或账号 | 2–12 积分 |
| [`trending`](https://socialtoai.app/zh/docs/mcp/tools.md) | 现在什么在火 | 2–12 积分 |
| [`detail`](https://socialtoai.app/zh/docs/mcp/tools.md) | 一条内容的正文和数据 | 1–12 积分 |
| [`comments`](https://socialtoai.app/zh/docs/mcp/tools.md) | 一条内容下的评论 | 2–12 积分 |
| [`user_profile`](https://socialtoai.app/zh/docs/mcp/tools.md) | 一个账号的简介和数据 | 1–12 积分 |
| [`user_posts`](https://socialtoai.app/zh/docs/mcp/tools.md) | 一个账号发过的内容 | 2–12 积分 |
| [`find`](https://socialtoai.app/zh/docs/mcp/tools.md) | Find what can be called by what the user wants done, in their words, English or Chinese: results are the calls, best first, with parameters, credits and a call that works; recommended, if any, is the tool or watch that does the whole job | 免费 |
| [`call`](https://socialtoai.app/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.app/zh/docs/mcp/tools.md) | What can be called now | 免费 |
| [`account`](https://socialtoai.app/zh/docs/mcp/tools.md) | Whose key or app this is: plan, balance, today's spend and limits | 免费 |
| [`brand_buzz`](https://socialtoai.app/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.app/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.app/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.app/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.app/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.app/zh/docs/mcp/tools.md) | Run one of these by name | 按实际调用计 |
| [`watch`](https://socialtoai.app/zh/docs/mcp/tools.md) | Daily watch: a search, action, op or tool we run again every day or week | 免费 |
| [`watch_news`](https://socialtoai.app/zh/docs/mcp/tools.md) | What the user's watches found that they have not been shown yet, newest first, with each watch, its time and status | 免费 |

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

## 逐个工具

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

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

```
Search a platform for content. Read-only. Each line: what to pass, then platforms at 2 credits a call unless numbered. A list of platforms: a call each. Failed calls cost 0. Need 100 items? Pass limit=100 (a call a page).
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, kuaishou 12, tiktok, wechat 12, wechat_channels 36, weibo, x 5, xiaohongshu 12, youtube, zhihu
With sort=latest: x
With type=image: xiaohongshu 12
since/until: ISO dates, all platforms.
More parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | 一个平台，或一组平台。 |
| `query` | string | 否 | 搜索词 |
| `sort` | string | 否 | 仅 bilibili、douyin、kuaishou、reddit、tiktok、wechat、wechat_channels、x、xiaohongshu、youtube、zhihu 支持。按平台：relevance、latest、popular、most_followers、fewest_followers、most_comments、most_favorites |
| `since` | string | 否 | 发布时间不早于：ISO 8601 日期（2026-10-01）或时间。平台没有这种筛选时按它最接近的时间范围取，再按 published_at 筛这一页；warnings 里会写明。 |
| `until` | string | 否 | 发布时间不晚于：ISO 8601 日期（含当天）或时间。平台没有这种筛选时按 published_at 筛这一页；warnings 里会写明。 |
| `published_within` | string | 否 | 仅 douyin、kuaishou、linkedin、reddit、tiktok、wechat、wechat_channels、xiaohongshu、youtube 支持。按平台：day、week、half_year、month、year |
| `type` | string | 否 | 仅 douyin、instagram、kuaishou、tiktok、wechat、wechat_channels、weibo、x、xiaohongshu、youtube、zhihu 支持。按平台：article、video、image、answer、user |
| `cursor` | string | 否 | 上一次返回的 page.cursor，其他参数保持不变。 |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

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

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | 一个平台，或一组平台。 |
| `board` | string | 否 | 仅 bilibili、douyin、reddit、weibo、x、xiaohongshu、zhihu 支持。按平台：hot_search、rising、topics、searches、music、low_fan、high_like、high_completion、high_follow、popular、trends、inspiration、hot |
| `type` | string | 否 | 仅 bilibili、douyin、reddit 支持。按平台：videos、trends |
| `region` | string | 否 | 仅 x 支持。哪个国家的热门，用两个字母的代码：US、GB、CA、AU、IN、JP、DE、FR、BR 或 MX；不填就是全球。 |
| `cursor` | string | 否 | 上一次返回的 page.cursor，其他参数保持不变。 |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |
| `limit` | integer | 否 | 想要多少条：这一次调用会一页接一页地取，直到够数或没有更多，每页按一次调用计费；用不到的页不扣。要 100 条就传 limit=100。 |

### `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 platforms at 2 credits a call unless numbered. A list of platforms, ids or links: a call each. Failed calls cost 0.
Give id|url: bilibili, douyin, instagram, kuaishou, linkedin, pinterest, reddit, telegram, threads, tiktok, weibo, x 1, xiaohongshu 12, youtube, zhihu
Give url: facebook, wechat 12
Give id|url|export_id: wechat_channels 12
With type=article|pin|question: zhihu
Add include=transcript, charged on top: instagram, linkedin, reddit, tiktok, x, youtube
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | 一个平台，或一组平台。 |
| `id` | string \| array | 否 | 视频编号，一串数字 |
| `url` | string \| array | 否 | 视频链接，原样粘贴即可：网页链接 https://www.tiktok.com/@账号/video/…、App 复制出来的 www.tiktok.com/t/… 或 vm.tiktok.com 短链接，或含这些链接的整段分享文字。短链接由我们打开一次，看它跳到哪条视频 |
| `lang` | string | 否 | Only tiktok, youtube |
| `export_id` | string \| array | 否 | The id of a search (platform=wechat_channels) result, starting with export/. It expires: use it soon after the search. The id returned is the video's numeric ID |
| `type` | string | 否 | 仅 zhihu 支持。按平台：article、pin、question |
| `include` | string \| array | 否 | 随每个结果一起取回的内容：transcript（逐字稿）。 |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

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

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | 一个平台，或一组平台。 |
| `id` | string \| array | 否 | 视频编号，一串数字 |
| `sort` | string | 否 | 仅 bilibili、reddit、xiaohongshu、youtube 支持。按平台：popular、latest、best |
| `reply_of` | string \| array | 否 |  |
| `url` | string \| array | 否 | 视频链接，原样粘贴即可：网页链接 https://www.tiktok.com/@账号/video/…、App 复制出来的 www.tiktok.com/t/… 或 vm.tiktok.com 短链接，或含这些链接的整段分享文字。短链接由我们打开一次，看它跳到哪条视频 |
| `cursor` | string | 否 | 上一次返回的 page.cursor，其他参数保持不变。 |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |
| `limit` | integer | 否 | 想要多少条：这一次调用会一页接一页地取，直到够数或没有更多，每页按一次调用计费；用不到的页不扣。要 100 条就传 limit=100。 |

### `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 platforms at 2 credits a call unless numbered. A list of platforms: a 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
Many creators? find_creators sizes them up in one run.
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | 一个平台，或一组平台。 |
| `id` | string | 否 | TikTok 用户编号，一串数字 |
| `url` | string | 否 | 主页链接，facebook.com/账号名 的写法 |
| `username` | string | 否 | TikTok 账号名，不带 @ |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

```
List what one account has published. Read-only. Each line: what to pass (a|b: either one), then platforms at 2 credits a call unless numbered. A list of platforms: a call each. Failed calls cost 0. Need 100 items? Pass limit=100 (a call a page).
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, tiktok, x, zhihu
Give username|url: linkedin
Give id|username: youtube
With type=answer|pin: zhihu
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `platform` | string \| array | 是 | 一个平台，或一组平台。 |
| `id` | string | 否 | 频道编号，UC 开头 |
| `url` | string | 否 | 主页链接，facebook.com/账号名 的写法 |
| `username` | string | 否 | TikTok 账号名，不带 @ |
| `type` | string | 否 | 仅 instagram、youtube、zhihu 支持。按平台：all、reel、video、short、answer、pin |
| `sort` | string | 否 | 仅 tiktok、youtube 支持。按平台：latest、popular |
| `tab` | string | 否 | 仅 wechat、x 支持。按平台：articles、videos、images、posts、replies、media |
| `cursor` | string | 否 | 上一次返回的 page.cursor，其他参数保持不变。 |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

```
Find what can be called by what the user wants done, in their words, English or Chinese: results are the calls, best first, with parameters, credits and a call that works; recommended, if any, is the tool or watch that does the whole job. Free. Asked about docs or code, adds the links. not_offered: results are only the closest: tell the user, never pass those off as what was asked for.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `query` | string | 是 | 想做什么，1 到 500 个字。 |
| `platform` | string | 否 | 只看这个平台。 |
| `limit` | integer | 否 | How many, 1 to 50; 5 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 102). Read-only. A failed call costs 0.
Ops per platform now: douyin 26, google 3, instagram 1, linkedin 2, meta 5, reddit 3, tiktok 10, wechat 6, wechat_channels 5, weibo 2, x 13, xiaohongshu 21, youtube 2, zhihu 3.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
Docs: https://socialtoai.app/docs/api/call/
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `op` | string | 是 | find 和 capabilities 给出的写法，比如 douyin.account_audience。 |
| `params` | object | 否 | 这个接口自己的参数，按名字给出。 |
| `cursor` | string | 否 | 上一次返回的 page.cursor，其他参数保持不变。 |
| `max_cost_credits` | integer | 否 | 调用花费超过这个数就拒绝，不扣积分。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

```
What can be called now. With platform: each action and op there, with parameters, credits, page size, fields it cannot give and a call that works. Without: only the platforms and how many calls each has. Free.
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 | 否 | This platform's calls. |

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

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

```
Whose key or app this is: plan, balance, today's spend and limits. Free. Scripts: for_scripts.
```

### `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 long run quotes 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 | 是 | 品牌、产品或话题的名字。 |
| `about` | string | 否 | 一句话说明它是什么，用来排除同名的其他东西。 |
| `compare_with` | array | 否 | 最多 2 个竞品。每个都按同样的方案读取，单独计价。 |
| `platforms` | array | 否 | 1 到 5 个平台。不填：按名字所用的语言选常用的三个（只选已开放的），返回里会写明。 |
| `window` | string | 否 | 往回读多久：7d、30d 或 90d。 |
| `scale` | string | 否 | small 每个平台最多读 40 条帖子，不读评论；medium 约 100 条帖子，并读其中 6 条的 2 页评论；large 约 200 条帖子，并读其中 15 条的 3 页评论。 |
| `max_cost_credits` | integer | 否 | 运行花费超过这个数就拒绝并给出报价，不扣积分。 |
| `confirm` | boolean | 否 | true：不论多少积分都直接运行。false：只回答方案和价格，什么都不运行。不填：花费较高或要在后台运行的，先回答价格。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

### `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 long run quotes 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 到 20 个帖子链接，可以来自不同平台。 |
| `focus` | string | 否 | 一句话说明你想了解什么，会额外找出与之相关的评论。 |
| `topics` | array | 否 | 你自己定的话题，最多 10 个；给了就跳过自动找话题这一步。 |
| `scale` | string | 否 | 总共最多读多少条评论，由各帖子分摊：small 200 条，medium 1,000 条，large 3,000 条；评论更贵的平台会少一些，返回里会写明。 |
| `max_cost_credits` | integer | 否 | 运行花费超过这个数就拒绝并给出报价，不扣积分。 |
| `confirm` | boolean | 否 | true：不论多少积分都直接运行。false：只回答方案和价格，什么都不运行。不填：花费较高或要在后台运行的，先回答价格。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

### `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 long run quotes its price first.
Credits by scale small/medium/large, for one search on one platform: bilibili 90/226/442; douyin 9/27/75; weibo 96/236/456; x 75/181/347; xiaohongshu 30/90/390; youtube, tiktok 92/228/444; instagram 93/229/445.
On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `query` | string | 是 | 细分领域，用关键词表示。 |
| `platform` | string | 是 | 一个平台。 |
| `followers_min` | integer | 否 | 达人粉丝数的下限。 |
| `followers_max` | integer | 否 | 达人粉丝数的上限。 |
| `brief` | string | 否 | 一句话说明你要找什么样的人，每个达人都按这句话来评判。 |
| `scale` | string | 否 | 取回主页和帖子的达人数：small 20 个，medium 50 个，large 100 个。 |
| `max_cost_credits` | integer | 否 | 运行花费超过这个数就拒绝并给出报价，不扣积分。 |
| `confirm` | boolean | 否 | true：不论多少积分都直接运行。false：只回答方案和价格，什么都不运行。不填：花费较高或要在后台运行的，先回答价格。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

```
What a set of accounts published lately and which posts did clearly better than each account's usual. It runs once. Runs on our side. A costly or long run quotes its price first. To repeat it daily, use watch.
Credits by scale small/medium/large, for one account: bilibili, youtube 10/12/22; douyin, reddit, weibo, 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 到 20 个账号主页链接，可以来自不同平台。 |
| `window` | string | 否 | 往回看多久的新帖子：7d 或 30d。 |
| `scale` | string | 否 | 每个账号：small 约 20 条帖子，medium 约 60 条，large 在 medium 基础上再读 2 条爆了的帖子的评论。 |
| `max_cost_credits` | integer | 否 | 运行花费超过这个数就拒绝并给出报价，不扣积分。 |
| `confirm` | boolean | 否 | true：不论多少积分都直接运行。false：只回答方案和价格，什么都不运行。不填：花费较高或要在后台运行的，先回答价格。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

### `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 long run quotes its price first.
Credits by scale small/medium, for one creator, starting on this platform, looked for on the default platforms: bilibili, x 34/58; douyin, weibo 26/50; kuaishou 58/88; reddit, facebook 47/59; wechat, wechat_channels 58/112; xiaohongshu 58/154; youtube 35/53; zhihu 38/56; instagram 34/46; linkedin, telegram, threads 47/-; tiktok 47/71.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `creator` | string | 是 | 达人主页的链接。 |
| `platforms` | array | 否 | 还要去找的其他平台：最多 3 个，scale 为 medium 时最多 6 个。不填：按达人所在平台选常用的三个（只选已开放的），返回里会写明。 |
| `scale` | string | 否 | medium 会额外抽读达人最新帖子下的评论，平台有的话还会取达人的商单主页。 |
| `max_cost_credits` | integer | 否 | 运行花费超过这个数就拒绝并给出报价，不扣积分。 |
| `confirm` | boolean | 否 | true：不论多少积分都直接运行。false：只回答方案和价格，什么都不运行。不填：花费较高或要在后台运行的，先回答价格。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

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

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

```
Run one of these by name. A costly or long run quotes its price first. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
batch_stats: 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: query, platform, window?, scale?, max_cost_credits?, confirm?. Credits by scale small/medium/large: bilibili, youtube 24/64/160; douyin 48/88/192; x 24/54/130; xiaohongshu 54/294/810; tiktok 36/76/178.
Docs: https://socialtoai.app/docs/mcp/tools/
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `tool` | string | 是 | batch_stats、viral_finder 之一。 |
| `inputs` | object | 是 | 该工具的输入，按名字给出。 |
| `handle` | string | 否 | 之前返回的句柄，或之前某次调用的 request_id：免费再读一次那个结果，不运行别的。 |

### `watch` (免费)

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

```
Daily watch: a search, action, op or tool we run again every day or week. The first run is the baseline; then only what is new goes to email, webhooks, a Feishu/WeCom/Slack chat, RSS and watch_news.
Two steps. action=preview with run (tool, action or op), inputs (as it takes them), every, time, timezone, name, delivery: tell the user preview.display. Only after they agree, action=confirm with its token.
list shows each watch's feed URL; pause, resume, delete, rotate_feed and revoke_feed take id. Each run is charged as the call itself; a free account keeps 1 watch. On error, follow error.fix.
```

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `action` | string | 是 |  |
| `run` | string | 否 | What runs each time: a tool (brand_buzz), an action (search) or an op. |
| `inputs` | object | 否 | Its inputs, as that tool takes them. |
| `name` | string | 否 | A short name, in the user's words. |
| `every` | string | 否 | day unless given. |
| `time` | string | 否 | HH:MM, 09:00 unless given. |
| `timezone` | string | 否 | The user's IANA time zone. |
| `delivery` | string | 否 | email, webhook, both (email unless given), or the user's group bot webhook URL (Feishu/Lark, WeCom, Slack) to post new items to that chat. |
| `token` | string | 否 | The preview's, to confirm it. |
| `id` | string | 否 | The watch's (from list), for pause, resume, delete, rotate_feed or revoke_feed. |

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

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

```
What the user's watches found that they have not been shown yet, newest first, with each watch, its time and status. Use it when the user asks what is new. Free. Pass id for one watch; what is shown is not shown again.
```

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