redfox-mcp-server
This server provides a unified MCP interface to 88 RedFox API tools for social media content discovery, analysis, creation, and downloading across multiple Chinese and global platforms.
Multi-platform search & trending: Search hot content, accounts, and rankings on Douyin, Xiaohongshu, WeChat/公众号, Bilibili, Kuaishou, Weibo, YouTube, X/Twitter, TikTok, Toutiao, and more.
Content & account analysis: Diagnose accounts (Douyin, Xiaohongshu, WeChat), find similar accounts, top account lists, growth rankings, and deep-dive reports.
Content creation support: Generate titles, rewrite copy in platform styles (Xiaohongshu, WeChat), get cover/title references, and write AI video/image prompts.
AI-powered tools: AI web search (DeepSeek, Doubao, Kimi), video generation (Seedance), image generation, and video prompt expert.
Data feeds & reports: Daily/weekly curated feeds for specific niches (AI, 文旅, short dramas, stock market) and cross-platform content ranking lists.
Word checking & compliance: Prohibited-word detection for multiple platforms (Douyin, Xiaohongshu, WeChat, Bilibili, Kuaishou) and multi-platform word check.
Media downloading: Download videos from Bilibili, TikTok, YouTube, Twitter/X, Instagram, WeChat Channels, Kuaishou, Xiaohongshu, and extract video subtitles/transcripts.
Comment & interaction queries: Get comments for Bilibili, Kuaishou, Weibo, YouTube, and Twitter posts.
Stock/finance content: Search stock-related viral content and query public-account investment articles.
Provides tools for Bilibili including keyword search, account discovery, portfolio search, comment retrieval, and video downloads.
Provides tools for Kuaishou including keyword search, account search, account works, comment retrieval, and video extraction.
Provides a TikTok video downloader tool.
Provides tools for WeChat Official Accounts (公众号) including search, writing, cover/title generation, account analysis, and video downloads.
Provides tools for Xiaohongshu (Little Red Book) including search, writing, title scoring, cover generation, note analysis, account analysis, and video downloads.
Provides tools for YouTube including video summarization, comment retrieval, and video downloads.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@redfox-mcp-serverFind the top trending videos on Douyin right now"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RedFox MCP Server
Wraps the 115 Agent Skills from the redfox-community repository into a single MCP server (Option 2: all tools available in one deployment).
91 tools directly callable (integrated with the real RedFox API)
Zero dependencies: pure native Node.js implementation (built-in fetch), no npm install, no Python required
Protocol: MCP (Model Context Protocol) over stdio, compatible with Qoder / Claude / Cursor and other clients
{
"mcpServers": {
"redfox-mcp-server": {
"command": "npx",
"args": ["-y", "redfox-mcp-server@latest"],
"env": { "REDFOX_API_KEY": "your-api-key-here" }
}
}
}Deploy to ModelScope MCP Plaza (Hosted Deployment)
ModelScope MCP Plaza supports hosted deployment of this server as a cloud MCP service, providing a dedicated Remote URL (SSE / Streamable HTTP) externally, so users can connect remotely without running it locally.
1. Publish the npm package (first time only)
cd redfox-mcp
npm login # 需要 npm 账号
npm publish # 包名 redfox-mcp-server,零依赖,37KB2. Create the service on ModelScope
Go to the creation page (or quickly create from a GitHub repository) and fill in:
Field | Value |
English name | redfox-mcp-server |
Hosting type | Hostable deployment |
Service config | Fill in the server config in |
Environment variable |
|
README | Feature description + usage instructions (this file can be used directly) |
The platform deployment check runs npx -y redfox-mcp-server@latest and calls tools/list (it has been verified that 91 tools are returned without an API Key, so the check passes smoothly).
3. User usage
On the service details page, users fill in their own REDFOX_API_KEY → click "Connect" → get a dedicated Remote URL:
https://mcp-<uuid>.api-inference.modelscope.cn/ssePaste it into any MCP client (Qoder / Dify / Tongyi Lingma, etc.) to remotely use all 91 tools.
Free deployment limits: up to 20 deployed services per user, 1 instance per service, ≤500 requests per 5-second window across all free services, and ≤50,000 requests total per user.
Related MCP server: rednote-analyzer-mcp
Quick Start
1. Get an API Key
Go to RedFox Hub to get your REDFOX_API_KEY.
2. Start the server
# Windows PowerShell
$env:REDFOX_API_KEY = "ak_xxxx..."
node server.js3. Configure in a client
Qoder: Add this server in the MCP configuration (use the npx method after publishing, or the node method for local development):
npx method (recommended, requires the npm package to be published):
{ "mcpServers": { "redfox-mcp-server": { "command": "npx", "args": ["-y", "redfox-mcp-server@latest"], "env": { "REDFOX_API_KEY": "ak_xxxx..." } } } }Local development method:
{ "mcpServers": { "redfox-mcp": { "command": "node", "args": ["E:\\path\\to\\redfox-mcp\\server.js"], "env": { "REDFOX_API_KEY": "ak_xxxx..." } } } }
The Qoder registration files (SERVER_METADATA.json + tools/*.json) are located in qoder-register/ and are automatically generated by gen-qoder-register.js.
Claude Desktop / Cursor: claude mcp add redfox-mcp -- node <path>/server.js
Tool List
Platform | Tools |
Douyin | douyin-search, douyin-hot-trend, douyin-daily-hot, douyin-content-surge, douyin-weekly-surge, douyin-rise-ranking, douyin-top-account, douyin-similar-account, douyin-account-diagnosis, douyin-ai-feed, douyin-prohibited-word, douyin-subscribe |
Xiaohongshu | xiaohongshu-search, xiaohongshu-write, xiaohongshu-title, xiaohongshu-title-score, xiaohongshu-cover, xiaohongshu-note-analyzer, xiaohongshu-dailytop, xiaohongshu-weeklytop, xiaohongshu-top-account, xiaohongshu-account-analyzer, xiaohongshu-similar-account, xiaohongshu-crawler, xiaohongshu-ai-feed, xiaohongshu-prohibited-word, xiaohongshu-rewrite, xiaohongshu-video-downloader |
WeChat Official Account | wechat-10w-hot, wechat-original-hot, wechat-search, wechat-write, wechat-cover, wechat-title, wechat-top-account, wechat-fastest-growing, wechat-similar-account, wechat-account-analyzer, wechat-prohibited-word, wechat-rewrite, wechat-video-downloader, gzh-astock-top |
Bilibili | bilibili-keywords-search, bilibili-keywords-accounts, bilibili-portfolio-search, bilibili-comment, bilibili-search-download, bilibili-video-downloader |
Kuaishou | kuaishou-search, kuaishou-accounts, kuaishou-account-works, kuaishou-comment, kuaishou-video-extract |
weibo-hot-search, weibo-realtime-search, weibo-post-search, weibo-comment-search | |
YouTube/X | youtube-digest, youtube-comment, youtube-video-downloader, twitter-comment, twitter-video-downloader |
TikTok | tiktok-video-downloader |
Multi-platform | cn-last30days, stock-feed, stock-analysis, multi-content-feed, trending-hub, trending-hub-top10, playlet--feed, cultural-tourism--feed |
AI Search | deepseek-websearch, doubao-websearch, kimi-websearch |
AI Generation | seedance-video-gen (video), visual-ops-writer (image), video-prompt-expert |
Tools | Prohibited-word detection (4 platforms), video download (8 platforms), multi-wordcheck |
Architecture
redfox-mcp/
├── server.js # MCP stdio 服务器入口(JSON-RPC 2.0)
├── tools-manifest.json # 自动提取的工具清单(从仓库脚本提取 API 端点/参数)
├── src/
│ ├── redfox-client.js # RedFox API 统一客户端(双请求头、错误处理、任务轮询)
│ ├── build-tools.js # 工具构建器(合并 manifest + overrides)
│ └── overrides.js # 人工校正层(精确参数映射、异步任务定义)
└── qoder-register/ # Qoder 注册文件(SERVER_METADATA.json + tools/*.json)Data Flow
MCP 客户端 ──JSON-RPC/stdio──> server.js ──> build-tools.js 工具注册表
│
▼
redfox-client.js(X-API-KEY 双发)
│
▼
https://redfox.hk/story/api/...Tool Parameter Design
Parameter names match the RedFox API payload fields (camelCase:
startDate/pageNum/pageSize)The
sourcefield is automatically filled in by the server asRedFoxMCP; callers do not need to pass itAsynchronous task tools (video generation / video-to-copy / comment retrieval) automatically submit + poll and return the final result directly
Regenerate the Tool List
After updating the repository scripts, re-extract the API information:
node mcp-extract-manifest.js "E:\path\to\redfox-community"
copy tools-manifest.json redfox-mcp\tools-manifest.json
node gen-qoder-register.js # 重新生成 Qoder 注册文件Tools Not Integrated (24)
The following Skills have no API endpoints (pure AI analysis / prompt-based) and are not registered as tools:
ai-intelligence-investigator, image-gen, redfox-skill-generator, redfox-subscribe, multi-copywrite-alchemy, pdf-image-text-extractor, seedream-5-lite, gzh-search, gzh-subscribe, video-downloader, douyin-works-crawler, tiktok-home-downloader, geo-analyzer, global-ai-news-brief, overseas-trending-search, wechat-account-analyzer, weibo-video-downloader, twitter-work-search, xiaohongshu-lowtop, etc.
To integrate them, add the corresponding endpoints in src/overrides.js and regenerate.
FAQ
Q: Tool calls return [NO_API_KEY]?
A: The REDFOX_API_KEY environment variable is not set. Please configure it before starting.
Q: Returns [BIZ_ERROR]?
A: The API Key is invalid or has insufficient permissions. Check the Key status on RedFox Hub.
Q: How to test?
node mcp-test-client.js list # 列出工具
node mcp-test-client.js call douyin-search test-args.json # 调用工具(参数从 JSON 文件读)Available Tools
88 toolsbilibili-commentA
获取B站视频评论,异步任务自动轮询结果
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | B站视频链接或BV号 | |
| offset | No | 分页游标 | |
| dataNum | No | 获取评论数量 | |
| sortType | No | 排序:2=按热度, 1=按时间 | 2 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the full behavioral disclosure burden. It does disclose a key behavioral trait: the operation is asynchronous and results are automatically polled. However, it does not cover read-only safety, authentication needs, failure modes, or what the initial call returns, leaving some behavior unexplained.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one compact, front-loaded sentence: the action and target come first, followed by the important async polling caveat. It contains no filler, repetition, or unnecessary schema duplication.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description is only minimally complete: it tells the agent what to call and that polling is automatic, while the schema handles parameters. It leaves gaps around return shape, error behavior, and the exact async workflow, which would matter for reliable agent invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all four parameters (url, offset, dataNum, sortType) already have meaningful documentation including defaults and an enum. The description adds only general context and no parameter-level detail beyond what the schema provides, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action and resource: fetch Bilibili video comments, and adds the notable async auto-polling behavior. It is clear and unique among the sibling tools, though it does not explicitly differentiate itself from tools like bilibili-video-downloader or bilibili-search-download.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives a clear target use case—retrieving comments for a Bilibili video—and the async polling detail sets expectations. However, it does not explicitly state when not to use it, mention alternatives, or provide exclusion criteria against the many sibling Bilibili and comment-related tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bilibili-keywords-accountsA
B站账号搜索,按关键词搜索B站UP主
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| order | No | 排序:totalrank=综合排序, fans=按粉丝数 | fans |
| keyword | Yes | 搜索关键词 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden. It states the core behavior—keyword-based account search—but does not disclose result shape, match semantics, pagination behavior, or any limits. For a read-only search tool this is a moderate gap rather than a serious safety issue.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence that front-loads the resource and action. There is slight redundancy between '账号搜索' and '搜索B站UP主', but overall it is efficient and free of filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple search tool with fully documented parameters, the description is minimally viable. However, without an output schema it does not hint at what the response contains, and it lacks usage differentiation from sibling Bilibili search tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for all three parameters, so the schema already documents keyword, page, and order. The description adds no parameter-specific meaning beyond what the schema provides, matching the baseline for full schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description uses a clear verb ('搜索') and a specific resource ('B站UP主/账号'), making the tool's purpose immediately understandable. The account scope also distinguishes it from sibling tools like bilibili-keywords-search, which by name targets general keyword content search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use when searching for Bilibili accounts/UP主 by keyword, but it gives no explicit when-to-use guidance or contrast against related siblings such as bilibili-keywords-search or bilibili-portfolio-search. No exclusions or alternative routing are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bilibili-keywords-searchB
B站内容搜索,按关键词搜索B站视频
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| keyword | Yes | 搜索关键词 | |
| sortType | No | 排序类型 | |
| publishTime | No | 发布时间 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description must carry the burden of explaining behavior. It only says it searches Bilibili videos; it does not disclose pagination behavior, sort/publishTime semantics, result format, rate limits, or whether it is a read-only operation. This is minimal for a search tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and front-loaded, containing only one sentence. It is efficient, though slightly redundant ('内容搜索' followed by '搜索B站视频'), and could have used the space to mention key parameters or alternatives.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With four parameters, no output schema, no annotations, and a large sibling set containing multiple Bilibili search tools, the description is under-specified. It does not explain how sortType/publishTime affect results, what the return data looks like, or how this tool differs from bilibili-search-download and bilibili-keywords-accounts.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so basic meanings of keyword, page, sortType, and publishTime are already documented. The description adds no value beyond confirming keyword-based search and does not explain sortType choices or publishTime formats, but the high schema coverage keeps this at baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('搜索') and resource ('B站视频'), and clarifies it is keyword-driven. It does not explicitly contrast itself with sibling tools like bilibili-search-download or bilibili-keywords-accounts, so it distinguishes the core operation but not the full sibling set.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The usage context is implied: an agent can infer this tool is for searching Bilibili videos by keyword. However, no explicit guidance is given for when to prefer this over bilibili-search-download, bilibili-keywords-accounts, or bilibili-portfolio-search, and no alternatives or exclusion conditions are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bilibili-portfolio-searchB
B站用户作品列表查询
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | B站用户UID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
没有提供注解,描述承担了完全的行为披露责任。它仅说明'查询',未提及分页、返回的元数据类型、认证要求、速率限制或可能的失败模式。对于只读操作,除'查询'外没有更丰富的上下文。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
描述是单句话,没有冗余或填充内容。核心功能被直接且前置地传达。每一部分都有价值,没有浪费的上下文。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
对于只有1个必填参数且无输出模式的简单工具,描述提供了最低限度的可操作性,说明了会返回作品列表,但未说明列表项的结构。由于复杂度低,这个缺口可以容忍,但若补充输出字段信息会更好。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
输入模式已完全描述了uid参数('B站用户UID'),覆盖率为100%。描述没有为uid增加额外语义,如格式、获取方式或约束。根据规则,当模式覆盖率高且描述未添加超越模式的信息时,基线得分为3是合适的。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
描述'B站用户作品列表查询'明确了一个特定的操作(查询)和资源(B站用户的作品列表)。'用户'和'作品列表'的组合使其与兄弟工具如bilibili-search-download和bilibili-comment清晰区分。尽管简短,但它唯一地定义了工具的功能。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
描述没有提供任何关于何时使用此工具而非替代方案的指导,例如与bilibili-search-download或bilibili-video-downloader的区别。没有排除条件、前提条件或选择偏好。Agent无法根据描述决定在哪些场景下优先使用此工具。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bilibili-search-downloadA
B站搜索批量下载工具。输入关键词即可搜索B站全站视频,支持按播放量/点赞/时间排序,搜索后自动批量获取全部高清下载链接。当用户需要查找B站视频、搜索B站内容、下载B站视频、采集B站素材时使用。触发词:B站搜索、bilibili搜索、B站下载、B站视频下载、b站搜视频、B站找素材、下载B站、bilibili下载。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| order | No | 排序方式(如 play) | play |
| keyword | Yes | 搜索关键词 | |
| pageSize | No | 每页数量 | |
| dateRange | No | 发布时间范围,如 7d=近7天 | 7d |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of disclosing behavior. It does disclose the core behavior: input keyword, search all Bilibili videos, sort by views/likes/time, and automatically batch-retrieve HD download links. However, it does not clarify whether this returns link lists only, whether actual downloads occur, or any limitations or side effects, leaving room for ambiguity.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded with the tool's core purpose, followed by use-case guidance and trigger words. The trigger word list is somewhat repetitive but serves a clear intent-detection purpose, so the length is justified.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description explains enough about expected behavior and return intent: it will search videos and get HD download links. Given the moderate complexity of five simple parameters and no output schema, the description is reasonably complete, though it could add more detail about pagination behavior or what the downloaded-link output looks like.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3, but the description adds meaning by explaining that the order parameter supports sorting by play count, likes, and time, which the schema's 'day-如 play' placeholder does not fully convey. It also reinforces that keyword is the primary required input, adding slight value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies a specific action and resource: searching Bilibili's full site by keyword and batch-retrieving HD download links. It is distinct from video-downloader siblings by emphasizing keyword-based search and batch behavior, though it does not explicitly name an alternative or contrast itself with bilibili-video-downloader.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use the tool: when the user needs to search Bilibili videos, download Bilibili content, or collect Bilibili material, and it provides trigger words for intent detection. It does not describe exclusions or when a different sibling tool would be more appropriate, so it falls one point short of full guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bilibili-video-downloaderA
根据视频链接下载B站视频,返回视频地址
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | B站视频链接(如 https://www.bilibili.com/video/BVxxxx) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does disclose the key behavior: download and return a video address. It does not mention limitations such as public availability, authentication, membership-only videos, or the exact form of the returned address, so disclosure is only minimally adequate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler. It states action, input, and output in compact Chinese, so every part earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter, no-output-schema downloader, the description is nearly sufficient: it names input and return value. It still lacks a note about accepted URL variants or error conditions, but these are minor for this complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100 percent and the schema already documents the url parameter with an example. The description only restates the idea of a video link, adding no new semantic detail beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: it downloads Bilibili videos from a video link and returns the video address. This clearly distinguishes it from platform-specific sibling downloaders such as youtube-video-downloader or tiktok-video-downloader.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The tool's purpose implies use when the user provides a direct Bilibili video URL, and the sibling names make platform selection easy. However, it never explicitly states when to prefer this over related Bilibili tools like bilibili-search-download or what URL forms are unsupported.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cn-last30daysA
全网多平台近30天内容搜索,按关键词跨平台查询爆款内容
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| keyword | Yes | 搜索关键词 | |
| platforms | No | 平台列表(逗号分隔),如 douyin,xiaohongshu,gongzhonghao | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry behavioral disclosure; it does indicate a query/search operation over a 30-day window across platforms. However, it does not describe return shape, result ordering, viral-content filtering semantics, pagination, or any limitations, so behavioral transparency is only partial.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler; every phrase contributes either scope or purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequate for a straightforward search tool: the required parameter is clear and all parameters have schema descriptions. However, with no output schema and no annotations, the description does not explain response format, supported platform codes, or behavior when start/end dates are omitted, leaving a moderate gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds value by signaling the default temporal window (last 30 days) and the viral-content intent, which are not fully captured in the individual parameter descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific action (search/query), a resource (multi-platform content), and an explicit temporal scope (last 30 days). The '跨平台' phrase clearly separates it from platform-specific siblings like douyin-search or xiaohongshu-search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description states the intended context: cross-platform, keyword-based, last-30-days viral-content search. It does not explicitly list when-not cases or alternatives, but the multi-platform and timeframe conditions give an agent enough signal to select this over single-platform siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cultural-tourism-bilibili-feedA
文旅B站信息源查询:按关键词与日期获取文旅类B站热门视频(点赞量排序)。数据每日15:00更新前一天,无数据日期必须确认后再查
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) | |
| keyword | No | 内容关键词,如 文旅、景区、旅游攻略(留空返回全部) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the burden and does disclose meaningful behavior: a daily 15:00 update lag, sorting by likes, and a no-data-date confirmation requirement. It does not mention auth, rate limits, or output details, but the disclosed behaviors are substantive for invocation decisions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single dense sentence that front-loads the tool's identity ('文旅B站信息源查询'), then state scope, sort order, update timing, and a caveat. Every clause earns its place with no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity, three-optional-parameter query tool, the description covers purpose, data freshness, sorting, and an important edge case about missing data. The only gap is that no output schema or return-shape description is provided, which is a minor omission for a feed-style tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents date, count, and keyword semantics. The description's mention of '按关键词与日期' adds nothing material beyond the schema, making the baseline 3 appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('获取') on a specific resource ('文旅类B站热门视频') and adds the sorting criterion (点赞量排序). It clearly distinguishes itself from sibling cultural-tourism feeds for other platforms by naming B站, and from generic Bilibili tools by the 文旅 qualifier.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives useful operational context: data updates daily at 15:00 for the previous day, and dates without data must be confirmed before querying. It does not explicitly compare to sibling alternatives like bilibili-keywords-search or cultural-tourism-douyin-feed, so it stops short of full alternative-routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cultural-tourism-douyin-feedA
文旅抖音信息源查询:按关键词与日期获取文旅类抖音热门作品(点赞量排序)。数据每日15:00更新前一天,无数据日期必须确认后再查
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) | |
| keyword | No | 内容关键词,如 文旅、景区、旅游攻略(留空返回全部) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the disclosure burden. It discloses useful behavior: results are sorted by likes, data has a daily 15:00 update lag for the previous day, and missing data requires confirmation. It does not detail return fields or side effects, but "查询" and the listed behavior make the read-only nature reasonably clear.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with the core purpose front-loaded and the update/missing-data caveat kept to one compact clause. Every part earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a read-oriented feed query with three optional parameters and no output schema, the description supplies key context: what is returned ("热门作品"), ordering ("点赞量排序"), freshness ("每日15:00更新前一天"), and a missing-data caution. Its only notable gap is not clarifying what the "确认后再查" confirmation process entails.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description echoes keyword and date concepts but adds no meaning beyond the schema, and it does not explain the count parameter. This is acceptable because the schema already documents all three parameters with defaults and limits.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific resource ("文旅抖音信息源") and a concrete action ("获取文旅类抖音热门作品"), and adds a sorting behavior ("点赞量排序"). Even without naming siblings, the 文旅/Douyin scope clearly separates it from other platform feeds and generic Douyin hot-topic tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It establishes a clear usage context: query by keyword and date for cultural-tourism Douyin hot content. It also gives operational timing ("数据每日15:00更新前一天") and a caution about missing dates ("无数据日期必须确认后再查"), though it does not explicitly enumerate sibling alternatives or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cultural-tourism-wechat-feedA
文旅公众号信息源查询:按关键词与日期获取文旅类公众号热门文章(阅读量排序)。数据每日15:00更新前一天,无数据日期必须确认后再查
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) | |
| keyword | No | 内容关键词,如 文旅、景区、旅游攻略(留空返回全部) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden and discloses meaningful traits: daily update timing, previous-day data coverage, no-data-date confirmation, and read-count ordering. For a non-destructive feed query this is strong context, though auth/rate-limit details are not covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tightly packed sentences: purpose and sorting in the first, data freshness and an operational caveat in the second. No filler; every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple query tool with 3 optional, fully documented parameters and no output schema, the description covers the return type (hot articles sorted by read count), data freshness, and the no-data behavior. The lack of an explicit output shape is a minor gap but does not block tool selection or invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description's 按关键词与日期 adds little beyond the schema, while the update-timing sentence adds minor contextual meaning to the date parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: 查询/获取文旅类公众号热门文章, sorted by 阅读量. The platform (公众号/WeChat) and topic (文旅) clearly distinguish it from sibling feeds such as cultural-tourism-bilibili-feed or wechat-10w-hot.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides usage context: query by keyword and date, data refreshes daily at 15:00 for the previous day, and dates with no data require confirmation. It does not explicitly state when to choose this tool over the many sibling wechat or cultural-tourism feeds, so selection is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cultural-tourism-xiaohongshu-feedA
文旅小红书信息源查询:按关键词与日期获取文旅类小红书热门笔记(点赞量排序)。数据每日15:00更新前一天,无数据日期必须确认后再查
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) | |
| keyword | No | 内容关键词,如 文旅、景区、旅游攻略(留空返回全部) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses meaningful behavioral traits: results are sorted by likes, data is refreshed daily at 15:00 for the prior day, and there is a no-data caveat requiring confirmation before querying. It does not describe the return format or what happens on an empty date, but the key operational behaviors are covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single compact sentence that leads with the tool's purpose, then the data freshness schedule, then the confirmation caveat. Every clause adds value and there is no redundant filler, making it easy to scan.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple query tool with three optional parameters and no output schema, the description covers what it does, how data is updated, and an important availability caveat. The 'must confirm' instruction is slightly ambiguous regarding how to confirm and what happens on missing dates, and no output shape is specified, but the core information needed for invocation is present.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline 3 applies. The description adds '按关键词与日期' and '点赞量排序', but that is largely restating schema intent or describing result ordering rather than adding new parameter semantics. It does not substantially compensate beyond what the schema already documents.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('获取', retrieve) and resource ('文旅类小红书热门笔记', cultural-tourism Xiaohongshu popular notes), with explicit criteria: keyword, date, and like-count ordering. The '文旅' prefix clearly distinguishes it from sibling Xiaohongshu feeds such as xiaohongshu-ai-feed and from platform-specific cultural-tourism feeds for Bilibili, Douyin, and WeChat.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear operational context: data updates daily at 15:00 for the previous day, and dates without data must be confirmed before querying. It does not explicitly name alternatives or state when not to use this tool, but the context is specific enough that an agent can infer the appropriate scenario.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
deepseek-websearchB
DeepSeek AI 联网搜索,输入问题返回AI搜索结果
| Name | Required | Description | Default |
|---|---|---|---|
| inquiryText | Yes | 搜索问题 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden and does communicate the key behavior: it connects to the web and returns AI-formatted search results. However, it does not disclose potential limitations like freshness, source coverage, or response format, which would be useful for a search tool without annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one compact sentence that front-loads the tool's core action and output. Every word contributes meaning, and there is no redundant or filler content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter, no-output-schema search tool, the description adequately covers the main invocation flow: enter a question, get an AI search result. It could be more complete by noting expected result structure, but the simplicity of the tool makes this a minor gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already documents inquiryText at 100% coverage with the description '搜索问题', so the tool description adds little beyond the schema. The phrase '输入问题' does reinforce the parameter's purpose but provides no extra formatting, constraints, or examples.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb and resource: it performs DeepSeek AI web search and returns AI-generated search results for an input question. It also indicates the provider, which helps distinguish it from sibling search tools like doubao-websearch and kimi-websearch, though it doesn't explicitly describe those distinctions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given about when to use this tool versus the many sibling search tools, such as doubao-websearch, kimi-websearch, or toutiao-search. The description implies usage for general questions but lacks any exclusions or alternative-selection cues.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
doubao-websearchB
豆包 AI 联网搜索,输入问题返回AI搜索结果
| Name | Required | Description | Default |
|---|---|---|---|
| inquiryText | Yes | 搜索问题 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It discloses that the tool performs an online AI search and returns an AI search result, which covers the core behavior. It omits any caveats, output detail, or limitations, but for a stateless search tool the basic behavior is stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One short, front-loaded sentence states the brand, the action, and the input/output behavior without filler. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with one fully documented parameter and no output schema, the description names the return value ('AI搜索结果') and the invocation pattern. It lacks a more concrete output structure or usage context, but is adequate for a simple search tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The single parameter inquiryText is already documented as '搜索问题'; the description's '输入问题' adds no new format, constraints, or semantic detail beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action ('联网搜索') and resource ('豆包 AI'), and specifies the input/output contract: a question yields AI search results. It is unambiguous, but it does not explicitly differentiate doubao-websearch from sibling tools such as deepseek-websearch or kimi-websearch, so it falls short of full sibling distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use or when-not-to-use guidance is provided. Given many sibling search tools (deepseek-websearch, kimi-websearch, toutiao-search, etc.), the agent is given no criterion for choosing this over alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-account-diagnosisB
抖音账号诊断工具,根据账号ID查询账号数据并生成诊断报告
| Name | Required | Description | Default |
|---|---|---|---|
| accountId | Yes | 抖音账号ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses the high-level action (querying data and generating a report), but does not describe side effects, report contents, data freshness, required permissions, or any limitations. It adds minimal behavioral context beyond the obvious purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single clear, front-loaded sentence that immediately communicates the tool's purpose and its core behavior. There is no filler or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple one-parameter schema, the description is adequate for basic invocation. However, there is no output schema, and the description does not clarify what the diagnosis report contains or how the agent should interpret the generated report, leaving some ambiguity about the tool's full behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents accountId as the Douyin account ID. The description only restates that account data is queried, adding no meaningful parameter semantics beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: querying Douyin account data and generating a diagnosis report based on account ID. This clearly distinguishes the tool as an account-level Douyin diagnosis tool, though it does not explicitly contrast it with sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied through the description: it is meant for diagnosing a Douyin account from its account ID. However, there is no explicit guidance on when to choose this tool over alternatives such as xiaohongshu-account-analyzer or kuaishou-accounts, and no exclusions or prerequisites are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-ai-feedA
AI抖音信息源 — 每日自动扫描抖音 AI 相关作品,按互动量(点赞/分享/评论)筛选最火内容,智能聚类生成精美 HTML 日报,支持封面图、数据指标和每日订阅。当用户需要 AI 抖音日报、抖音AI热点、AI抖音内容、抖音信息源、douyin ai feed 时使用。
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | keyword | |
| pageNum | No | pageNum | |
| pageSize | No | pageSize |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It does well by revealing the automated daily scan, the selection criteria (interaction metrics), and the output form (HTML daily report with cover images and data metrics). However, it leaves ambiguity about what happens on invocation—whether it returns a report or sets up a subscription—and does not cover side effects or prerequisites.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, each earning its place: the first packs core capabilities (scan, filter, cluster, generate HTML report) efficiently, the second lists trigger phrases. No redundant wording or irrelevant detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description explains the core deliverable (HTML daily report) and the selection logic, but with no output schema and no annotations, it leaves important call semantics unclear. For instance, it does not specify whether the tool returns the report directly or whether the '每日订阅' feature is activated automatically. The roles of pageNum/pageSize also remain vague, making the description incomplete for an agent deciding how to invoke it.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but the descriptions are just parameter names ('keyword', 'pageNum', 'pageSize') without added meaning. The tool description implies keyword refers to the AI topic being scanned, but it does not clarify how pageNum and pageSize affect the report. Since the high schema coverage warrants a baseline of 3 and the description adds only marginal parametric nuance, a 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear, specific function: scanning Douyin AI-related content daily, ranking by engagement, clustering, and generating an HTML report. This distinctively separates it from sibling tools like douyin-search or douyin-daily-hot. The resource (Douyin AI works) and the action (scan/filter/cluster/generate report) are both explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives concrete triggers: '当用户需要 AI 抖音日报、抖音AI热点、AI抖音内容、抖音信息源、douyin ai feed 时使用.' This provides clear context for when to use the tool. However, it does not explicitly state when not to use it or mention alternatives like douyin-daily-hot for general Douyin hot content, so it earns a 4 rather than a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-content-surgeC
抖音内容突增榜,查询互动数据突增的爆款内容
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 榜单类型:1=突增榜, 2=周突增榜 | 1 |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden. It only signals read-only behavior through '查询' and does not describe what the returned ranking contains, how surge is computed, whether startDate is necessary, or any response-shape details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that leads with the resource and follows with the purpose. It is appropriately brief, though the brevity comes at the cost of behavioral and contextual detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description should at least characterize the returned data and ranking behavior. It does not explain what fields are returned, how the date parameter affects results, or how this surge ranking behaves relative to other ranking tools, leaving an agent with significant gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents the type options and the startDate format. The description adds no parameter-specific meaning, which matches the baseline of 3 for fully covered parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific resource, the Douyin content surge ranking, and a concrete action: querying viral content with surging interaction data. It is clear and read-oriented, though it does not explicitly distinguish itself from closely related siblings such as douyin-weekly-surge or douyin-rise-ranking.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies a use case but gives no explicit guidance on when to use this tool versus alternatives. With many sibling ranking tools present, there is no when-to-use or when-not-to-use guidance to help an agent route correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-daily-hotC
抖音每日爆款榜,查询每日点赞排行最高的作品
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 榜单类型 | 1 |
| endDate | No | 结束日期 YYYY-MM-DD | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It only reveals that the tool is a read-style query ('查询'), but does not disclose what happens with empty parameters, how the date range behaves, what the 'type' values represent, or whether results are limited or paginated. The ordering-by-likes hint is useful but minimal.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler words; it states the tool name's subject and the query function efficiently. It could have used the brevity to also convey behavioral details, but as written it wastes no words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations, no output schema, and three loosely described parameters (including an ambiguous 'type'), the description is not complete enough for an agent to call the tool confidently in edge cases. The presence of zero required parameters is not explained, and the agent cannot know what a no-argument call returns or what valid type values exist.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds marginal context by framing the date parameters as belonging to a 'daily' ranking, but it does not clarify the meaning of the 'type' parameter (no enum, only a default of '1') or whether startDate/endDate must be used together.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb-resource pair (查询/query + 抖音每日爆款榜/Douyin daily viral list) and adds a clear selection criterion: works ranked by highest daily likes. It is not a tautology of the name because the second clause adds the 'likes ranking' detail. However, it does not explicitly distinguish itself from closely related siblings like douyin-hot-trend, douyin-rise-ranking, or douyin-weekly-surge.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description offers no guidance on when to use this tool versus alternatives, no named sibling tools, and no mention of prerequisites such as whether date parameters should be paired. An agent is given zero context for choosing this over the many other Douyin ranking/trend tools in the sibling list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-hot-trendA
抖音热点趋势查询,不填日期返回实时热榜,可查询指定时间段的热门话题
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD(不填为实时榜) | |
| startDate | No | 起始日期 YYYY-MM-DD(不填为实时榜) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral transparency burden. It discloses the main mode-switching behavior (empty vs. filled dates) but does not describe the return shape, what happens if only one date is supplied, range limits, pagination, or sorting behavior. This is adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no filler. Every clause adds meaningful information: the resource, the default behavior, and the optional time-range capability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter tool this is mostly adequate, but the lack of an output schema raises the burden on the description to clarify return expectations. It does not address edge cases like a single date being provided, and only vaguely indicates the output is '热门话题'. An agent could invoke it correctly, but some ambiguity remains.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds valuable relational semantics by explaining that empty dates yield real-time results while filled dates query a specific period, reducing ambiguity around how the two optional parameters interact.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('查询' - query) and resource ('抖音热点趋势' - Douyin hot trends), and clarifies two modes: real-time hot list without dates, and hot topics for a specified time period. It does not explicitly differentiate itself from siblings like douyin-daily-hot or douyin-rise-ranking, so it falls just short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear usage context: leave dates empty for the real-time hot list, or provide a date range for historical hot topics. However, it does not mention alternative tools or exclusions, so it lacks the explicit when-to-use-vs-alternatives guidance needed for a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-prohibited-wordB
抖音违禁词检测,检查文案中的敏感词
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 待检测文案内容 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states what the tool detects ('敏感词') but does not explain what the output looks like, whether it returns the matched words, severity levels, suggestions, or just a pass/fail result. It also doesn't mention any limitations such as the word list being fixed or updated periodically.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence that is front-loaded with the platform and purpose. It wastes no words, though it could add a bit more behavioral detail without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool with no output schema and no annotations, the description is too thin. An agent does not know what the return result will be, whether the tool flags offending words or just returns true/false, or whether there are any platform-specific nuances. The sibling tool 'multi-wordcheck' might be a better candidate for multi-platform checks, but the description doesn't help an agent choose.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the single parameter 'content' is already documented as '待检测文案内容' (copy content to be checked). The description adds the context that it's for Douyin prohibited-word detection, but it doesn't add extra meaning beyond the schema, such as expected format, length limits, or language requirements. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific verb ('检测' / check) and resource ('抖音违禁词' / Douyin prohibited words), and the input schema confirms it takes copy text. However, it does not explicitly differentiate itself from the sibling 'xiaohongshu-prohibited-word' or the multi-platform 'multi-wordcheck', so it lacks direct sibling distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage: use this when checking Douyin copy for prohibited/sensitive words. But there is no explicit when-to-use or when-not-to-use guidance, and no mention of alternatives like 'xiaohongshu-prohibited-word' or 'multi-wordcheck' for other platforms. Usage context is clear from the platform-specific name, but exclusions are missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-rise-rankingC
抖音涨粉榜,查询指定日期的账号涨粉排行
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | 分类 | |
| dateType | No | 日期类型:1=日榜, 2=周榜 | 1 |
| rankDate | Yes | 榜单日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only restates the query intent and does not disclose sort order, output format, pagination, or behavior when no ranking data exists for the given date.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence with no wasted words, front-loading the ranking concept before the action. It is appropriately concise for a simple query tool, though it sacrifices useful context for brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple three-parameter query where the schema covers 100% of the parameters, the description is minimally adequate. However, there is no output schema, no behavioral context, and no differentiation from sibling Douyin ranking tools, so the overall context remains incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the parameters are already documented in the schema. The description itself adds no parameter meaning beyond what the schema provides, and the vague 'category' field remains vague, but the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('查询') and resource ('抖音涨粉榜', account follower-growth ranking) with a date qualifier. It is clear enough to be distinguished from sibling tools like douyin-daily-hot or douyin-top-account, though it does not explicitly compare itself to any alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use this tool versus the many other Douyin ranking/surge tools. The only implied context is '指定日期', but there are no exclusions, alternatives, or prerequisites, and no mention of how dateType interacts with the date.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-searchB
抖音作品查询工具。根据关键词搜索抖音热门爆款作品,支持按日期范围筛选
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| keyword | Yes | 搜索关键词,空字符串查询全站热门 | |
| pageNum | No | 页码 | |
| pageSize | No | 每页数量(最大50) | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
无任何注解,描述需承担全部行为披露责任。'热门爆款作品'这一范围限定是有效的行为信息——说明这不是全量搜索而是热门内容搜索;日期筛选也是行为特征。但未说明结果排序规则、'爆款'的判定标准、翻页行为或调用限制。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
描述仅两个短句、无冗余修饰,核心动作和范围控制在前端。首句'抖音作品查询工具'与工具名略有重复,但作为领域锚点可接受;第二句承载了主要信息量,整体精炼高效。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
对5参数、无输出schema的工具而言,基本调用方式是明确的:关键词必填、日期可选、分页参数有默认值。但无输出schema的情况下描述未提及返回内容形态(如视频数据、作者信息、热度指标),也未说明'爆款'筛选逻辑,agent难以预判结果结构。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema描述覆盖率为100%,所有5个参数(keyword、startDate、endDate、pageNum、pageSize)在schema中已有说明。描述中'按日期范围筛选'只是重复schema已有信息,但'热门爆款'为keyword参数提供了一点语义上下文(搜索目标限定为热门作品),整体处于基准水平。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
描述包含具体动词(搜索)、资源(抖音作品)和范围限定(热门爆款、按日期筛选),能清晰传达这是关键词搜索工具。在众多抖音相关兄弟工具中(douyin-hot-trend、douyin-daily-hot、douyin-top-account等),关键词搜索这一特性将其与feed/榜单/账号类工具区分开,但未明确指出具体不同于哪一兄弟工具。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
描述完全没有提及何时使用此工具或何时使用替代工具。面对大量抖音内容探索类兄弟工具(douyin-hot-trend、douyin-content-surge、douyin-ai-feed等),agent无法获知关键词搜索与热门趋势/feed流工具之间的选择条件,也没有任何排除性说明。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-similar-accountA
查询抖音相似账号,根据账号ID或名称匹配对标账号
| Name | Required | Description | Default |
|---|---|---|---|
| accountId | No | 抖音账号ID | |
| accountName | No | 抖音账号名称 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It only says '查询' (query), implying a read operation, but doesn't disclose output format, whether a list/ranking is returned, data source, or any constraints such as requiring at least one parameter. This is thinner than expected for an annotation-free tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, front-loaded sentence: the core purpose comes first, followed directly by the matching criteria. There is no redundant or filler content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter query tool with no output schema, the description is mostly adequate, but it leaves a practical gap: because both parameters are optional, it doesn't say whether at least one must be supplied or what happens if neither is provided. The return content is only vaguely described as '对标账号'.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Both parameters are already documented in the schema with 100% coverage, so the baseline is 3. The description adds the useful nuance that accountId or accountName can be used to match, but adds no detail about precedence, required-at-least-one, or how the values are interpreted.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description begins with '查询抖音相似账号' (query Douyin similar accounts), a specific verb and resource, and then specifies matching criteria '根据账号ID或名称'. Its 'similar account' function is distinct from siblings like douyin-account-diagnosis or douyin-top-account.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The tool's unique purpose is implied by '相似账号/对标账号', so an agent can infer when to use it, but the description never explicitly states when to choose this tool over alternatives or any exclusions. It gives the matching basis (ID or name) but no usage conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-subscribeA
抖音账号订阅追踪 — 通过抖音号订阅账号(最多20个),Agent 每日 9:00 自动拉取并生成 HTML 报告。账号 ID 直接内置于自动化命令中,无需文件存储。支持多抖音号批量订阅,自动生成精美 HTML 作品报告,终端/Markdown 表格按账号依次展示作品标题、收藏、评论、分享、点赞、发布时间等数据。当用户订阅抖音账号、追踪抖音作品更新、监控抖音竞品账号时使用。触发词:抖音订阅、抖音账
| Name | Required | Description | Default |
|---|---|---|---|
| pageNum | No | pageNum | |
| shortId | No | shortId | |
| category | No | category | |
| pageSize | No | pageSize | |
| accountId | No | accountId | |
| accountName | No | accountName |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full disclosure burden and does substantial work: it reveals the scheduled daily 9:00 auto-pull behavior, HTML report generation, that account IDs are embedded directly in automation commands without file storage, and the exact output fields (title, favorites, comments, shares, likes, publish time). It omits auth requirements, rate limits, and behavior at the 20-account cap, but the disclosed traits are far above average.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The core purpose is front-loaded in the first clause, followed by ordered content on behavior, output format, use cases, and trigger words. It is slightly redundant ('生成 HTML 报告' and '自动生成精美 HTML 作品报告' both appear) but otherwise every sentence earns its place without excessive length.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 6 parameters, no annotations, and no output schema, the description covers the essential ground: purpose, the 20-account limit, schedule, output format (HTML plus terminal/Markdown tables with listed fields), and use cases. The main gap is that none of the six parameters are mapped to their meanings, which an agent must infer from context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is nominally 100%, but every parameter description is tautological (e.g., 'pageNum' described as 'pageNum', and accountName typed as number), so the schema adds no real meaning. The description provides only indirect hints — subscribing via 抖音号 likely maps to shortId, and '账号 ID 直接内置于自动化命令中' relates to accountId/accountName — but never explicitly maps the six parameters, keeping this at the baseline of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with '抖音账号订阅追踪 — 通过抖音号订阅账号(最多20个)', a specific verb (订阅/subscribe) paired with a resource (抖音账号/Douyin accounts) and an explicit scope cap (20 accounts). This clearly separates it from sibling tools like douyin-search, douyin-account-diagnosis, and douyin-top-account, which serve different purposes. The trigger words and use-case sentence reinforce what this tool uniquely does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'当用户订阅抖音账号、追踪抖音作品更新、监控抖音竞品账号时使用' states clear conditions for use, and the trigger words ('抖音订阅、抖音账') give operational signals an agent can key on. It does not name specific sibling alternatives or state when not to use the tool, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-top-accountC
抖音头部账号榜,查询抖音最具影响力账号排行
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 榜单类型 | |
| dateType | No | 日期类型:1=日榜, 2=周榜 | 1 |
| rankDate | Yes | 榜单日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It only says the tool queries a ranking; it does not describe return format, pagination, permissions, rate limits, or whether the type parameter changes the result set. The single verb 查询 implies a read operation, but little else is disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, front-loaded sentence with no wasted words; though '头部账号榜' and '最具影响力账号排行' are near-synonyms, the description is appropriately compact for a simple query tool. It would earn a 5 if it added a useful usage hint while staying concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Without an output schema or annotations, the description should compensate by explaining what the agent will receive and how parameters like type and dateType affect results. It does neither. The sibling list contains several similar Douyin ranking tools, and the description provides no context to disambiguate among them.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents all three parameters (type, dateType, rankDate) with individual descriptions. The description adds no parameter-level meaning, but the schema does the heavy lifting, so the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a concrete verb (查询) and a clear resource (抖音头部账号榜, 抖音最具影响力账号排行), so an agent can tell it queries a ranking of top Douyin accounts. However, it does not explicitly differentiate it from sibling Douyin ranking tools like douyin-rise-ranking or douyin-daily-hot, so it falls just short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no guidance on when to use this tool versus alternatives. It does not mention that it is for influencer/account rankings rather than rising accounts or daily hot topics, nor does it reference sibling tools. The agent must infer applicability from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
douyin-weekly-surgeC
抖音周突增榜,查询本周互动数据突增的爆款内容
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 榜单类型 | 2 |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure, but it offers only a single claim: it queries surging viral content for the week. It does not disclose what the ranking type parameter variations produce, how startDate interacts with the '本周' claim, output shape, pagination, or any rate-limit/auth considerations. Too thin for an unannotated tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence with minimal waste, front-loading the ranking name and then the clarifying query statement. The opening '抖音周突增榜' slightly mirrors the tool name, but the second clause earns its place by specifying the resource and surge/interval criteria.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite being a simple two-parameter tool, key context is missing: the meaning and valid values of 'type', the relationship between startDate and the stated 'this week' behavior, and any differentiation from siblings. With no output schema to cover return values, the description should explain more about what constitutes the returned '爆款内容' and ranking semantics.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. Both parameters have descriptions, with startDate's format clearly stated and the description's '本周' adding loose context for date relevance. However, 'type' remains vague ('榜单类型' with a default of '2' but no enum or value explanations), and the description does not clarify which types exist or what '2' means.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('查询'), resource (本周互动数据突增的爆款内容 — this week's viral content with surging interaction data), and temporal scope ('本周' weekly), making the core function clear. However, it does not explicitly differentiate itself from closely related siblings like douyin-content-surge or douyin-rise-ranking, whose names imply overlapping functionality.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no guidance on when to choose this tool over the many similar Douyin ranking siblings (douyin-daily-hot, douyin-hot-trend, douyin-rise-ranking, douyin-content-surge). Usage context is only implied by the word '本周' — there is no when-not-to-use guidance or explicit alternative routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gzh-astock-topA
公众号A股大V榜,按关键词搜索公众号账号排行(默认A股领域,返回账号与最新文章数据)
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | 偏移量 | |
| keyword | No | 搜索关键词(默认 A股) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full disclosure burden. It does reveal the search behavior, the default A-share domain, and that the result contains account and latest-article data. It stops short of explaining ranking criteria, pagination behavior, or any limits or permissions, so it is only moderately transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence with a parenthetical that packs in the domain, action, default, and returned data. There is no filler or redundancy, and the most identifying information is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with two optional parameters, the description is mostly adequate: it identifies the returned data and the default keyword behavior. However, without an output schema or annotations, the exact response shape, ranking order, and offset semantics remain underspecified.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds some semantic context to keyword by noting the default A股 domain and the expected output, but offset is only documented in the schema as '偏移量' and receives no additional explanation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb (搜索), a clear resource (公众号账号排行), and a domain (A股), and even states the return contents (账号与最新文章数据). It is clearly more informative than the name alone, though it does not explicitly contrast itself with sibling tools such as wechat-top-account or stock-feed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrasing '按关键词搜索公众号账号排行(默认A股领域)' implies the intended use case: find WeChat public-account A-share rankings by keyword. However, there is no explicit guidance about when to prefer this tool over sibling ranking/search tools or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
instagram-video-downloaderB
根据视频链接下载Instagram视频
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Instagram视频链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description bears full responsibility for behavioral disclosure. It only says 'download' and does not explain what the tool returns (file vs URL), whether authentication or rate limits apply, how invalid links are handled, or any side effects beyond the core action.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, direct sentence with no filler or repetition. Every word contributes to the meaning, and the essential information is front-loaded in an appropriately minimal way for a one-parameter tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With only one parameter, no annotations, and no output schema, the definition is minimally viable: it names the action and the required input. However, it omits any description of the return value or behavior on error, which an agent would need to know to fully trust and use the result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with the url parameter already described as 'Instagram视频链接'. The description's mention of '根据视频链接' adds no new meaning beyond the schema, so the baseline of 3 applies; there is no additional parameter context to compensate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('下载' / download), a specific resource ('Instagram视频'), and the input type ('根据视频链接' / based on video link). It clearly distinguishes this tool from sibling downloaders such as tiktok-video-downloader and youtube-video-downloader by platform.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given about when to use this tool versus alternatives. The description does not mention exclusions, preconditions, or the conditions under which a user should choose instagram-video-downloader over a sibling downloader; the agent must infer this solely from the platform name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
investor-distillerB
公众号投资大V文章列表查询(蒸馏器素材采集):按公众号微信号分页拉取文章列表,支持用文章UUID精确获取单篇
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | 分页偏移量 | |
| account | Yes | 公众号微信号 | |
| workUuid | No | 文章UUID(精确获取单篇时填写) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the core read behavior: paginated fetching by account and exact single-article fetching by UUID. However, it does not disclose potential side effects, authentication needs, rate limits, result ordering, or what happens when the account or UUID is invalid—gaps that would matter for an agent deciding how to invoke it.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that front-loads the core purpose and then specifies the two retrieval modes. The parenthetical '蒸馏器素材采集' adds some project-specific context but does not bloat the text. Every essential clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with three parameters, full schema coverage, and no output schema, the description gives adequate but incomplete context. It explains the main query modes and required parameter, but does not clarify result shape, pagination defaults, or the relationship between offset and workUuid. These details are not covered elsewhere, leaving notable gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description reinforces the meanings of account (公众号微信号), offset (分页), and workUuid (精确获取单篇), but adds no new detail beyond the schema, such as pagination size, UUID format, or the interaction between offset and workUuid.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries article lists from WeChat public-account investment influencers ('公众号投资大V文章列表'), identifying the resource and verb. It also distinguishes two usage modes: paginated list pulling by account and exact single-article retrieval by UUID. It doesn't explicitly name sibling alternatives, so some differentiation is inferred rather than stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use the tool: when needing a paginated article list for a specific WeChat public account, or a single article by UUID. However, it provides no explicit guidance about when not to use it or which sibling tool to choose instead, such as generic wechat-search or gzh-astock-top. The usage context is functional but not comparative.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
kimi-websearchB
Kimi AI 联网搜索,输入问题返回AI搜索结果
| Name | Required | Description | Default |
|---|---|---|---|
| inquiryText | Yes | 搜索问题 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of disclosing behavior. It states the basic function and that the result is an 'AI search result', but it does not describe the result format, whether sources are included, or any operational constraints or limitations. The agent is left guessing about the response structure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one short, front-loaded sentence with no filler. It states the brand, the action, the input, and the output in compact form. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter tool with no output schema, the description gives a high-level idea of input and output but not enough detail about the returned 'AI search result'. It also lacks usage context relative to sibling search tools, so it is minimally viable rather than complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents inquiryText as '搜索问题'. The tool description simply restates that the user provides a question ('输入问题') without adding new meaning. This matches the baseline of 3 for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action and resource: 'Kimi AI 联网搜索' (Kimi AI online search) and the outcome '输入问题返回AI搜索结果' (input a question and return AI search results). It is specific enough to distinguish from video-downloader and feed tools, though it does not directly contrast with the sibling AI search tools like deepseek-websearch or doubao-websearch.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no guidance on when to use this tool versus the many sibling search tools. There are no exclusions, no mention of preferred scenarios, and no comparison to deepseek-websearch, doubao-websearch, toutiao-search, or other search-related siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
kuaishou-accountsA
快手账号搜索工具(广域库)。通过账号名称模糊搜索快手账号,返回 kwaiId、昵称、头像、简介等,kwaiId 可直接用于查询该账号作品列表。当用户需要按名称搜索快手账号、查找快手博主、定位达人账号、获取账号kwaiId时使用。触发词:快手账号搜索、查快手账号、找快手博主、账号名称搜索、搜快手达人。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| pageSize | No | 每页数量(最大50) | |
| accountName | Yes | 快手账号名称 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It does disclose the fuzzy-search behavior, return fields, and a downstream use for kwaiId, which is helpful. However, it does not mention pagination behavior, result limits, data freshness, authentication needs, or potential empty results. These are gaps for a tool that might be called programmatically.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded with the core purpose and return values, followed by explicit use cases and trigger words. The use-case list has some redundancy (e.g., '查快手账号' and '搜快手达人' overlap with the main purpose), but the overall structure is efficient and leaves little waste.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple search tool with one required parameter and no output schema, the description covers the essential return items and even points to the sibling tool for works lookup. It is complete enough for an agent to call correctly, though it could be more explicit about pagination defaults. The schema already handles page/pageSize, so the absence of that detail in the description is acceptable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds the '模糊搜索' (fuzzy search) nuance for accountName, which is useful beyond the schema's plain '快手账号名称'. Page and pageSize are already fully documented in the schema, so no additional meaning is needed there. Overall, the description adds only marginal semantic value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('搜索'), resource ('快手账号'), and mechanism ('通过账号名称模糊搜索'), and lists concrete return fields (kwaiId、昵称、头像、简介). It also distinguishes itself from the sibling kuaishou-account-works tool by explicitly noting that kwaiId can be used to query the account's works list. The trigger words further reinforce the intended use.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description clearly states when to use this tool: '当用户需要按名称搜索快手账号、查找快手博主、定位达人账号、获取账号kwaiId时使用'. This provides explicit context for invocation. However, it does not explicitly mention when not to use it or name alternative sibling tools (e.g., kuaishou-search), though the kwaiId-to-works pointer indirectly helps route to kuaishou-account-works.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
kuaishou-account-worksC
快手账号作品查询,按账号查询作品列表
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| size | No | 每页数量 | |
| userId | Yes | 快手用户ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. The word '查询' implies a read operation, but nothing is said about response structure, pagination caps, accepted ID format, authentication needs, or what fields a '作品' item contains. The description adds essentially no behavioral context beyond the query intent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single eight-character clause with zero filler; the action and target are front-loaded and immediately scannable. It is appropriately compact for a simple paginated list query, though slightly more structure (e.g., a note on output or usage context) would have cost little.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description bears extra responsibility, and it only states that a works list is returned without describing its shape. For a simple 3-parameter paginated query with fully documented params, this is near-adequate for invoking the tool, but it leaves open how to source the userId and what the returned list contains.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with page, size, and userId all documented in the schema. The description's '按账号' merely restates the userId concept and adds the 'list' interpretation, but contributes no format, constraints, or relationships beyond what the schema already provides. The baseline of 3 applies because the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '快手账号作品查询,按账号查询作品列表' states a specific query action and a clear resource (a Kuaishou account's works list), going beyond a restatement of the tool name. It does not explicitly differentiate itself from siblings like kuaishou-accounts or kuaishou-video-extract, but the '按账号查询作品列表' phrasing makes the core scope unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description offers no guidance on when to use this tool versus alternatives, and no exclusion criteria or prerequisites. With four Kuaishou-related siblings (kuaishou-accounts, kuaishou-search, kuaishou-comment, kuaishou-video-extract), an agent is left to infer the selection rationale, and there is no hint about how to obtain the required userId.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
kuaishou-commentC
快手作品评论查询
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | 分页游标 | |
| opusId | Yes | 快手作品ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure, but it only says '查询' (query) and names the target. It does not disclose pagination behavior via the cursor, return format, sorting, or any rate limits or auth requirements, even though the cursor parameter implies paginated fetching.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a six-character noun phrase that functions more as a title than an explanation. It is concise with no filler, but it is under-specified and does not provide the structural clarity expected of a tool description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema and no annotations, so the description should explain what the tool returns and how pagination works. It only names the resource, leaving the agent to guess whether the output is a list, includes user info, or how cursor-based paging behaves.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline of 3 applies. The description adds no extra meaning about the opusId format or how the cursor should be used, but every parameter is already documented in the input schema, so the description does not need to compensate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear query operation ('查询') on a specific resource ('快手作品评论'), and the tool name makes the platform and resource explicit. It is unambiguous enough to distinguish from siblings like bilibili-comment or twitter-comment by platform, though it doesn't specify whether results are a list of individual comments or an aggregate.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as kuaishou-account-works or kuaishou-search, nor any prerequisites like how to obtain an opusId. The usage context must be inferred entirely from the tool name and input schema.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
kuaishou-searchA
快手作品搜索工具。输入关键词就能搜到快手热门作品(广域库),支持按排序方式多维度筛选,作品标题、作者、播放数、点赞数、评论数、收藏数一览无余,点一下链接就能跳转看详情,还可提取视频详情和文案。当用户需要搜索快手作品、查找快手热门内容、查询快手作品数据时使用。触发词:快手搜索、快手作品、快手热门、快手视频查询、搜快手。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | page | |
| size | No | size | |
| sort | No | sort | |
| keyword | Yes | keyword |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry behavioral disclosure. It does disclose key behavior: searching returns work stats, links open details, and it can extract video details and copy. However, it does not mention output format, pagination behavior, rate limits, or whether any authentication or permissions are required, which leaves some transparency gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is efficient and front-loaded with the primary purpose, followed by output fields and usage triggers. The trigger-word list is somewhat redundant with the usage sentence, but overall every sentence contributes useful orientation.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 4-parameter tool with no output schema and no annotations, the description covers purpose, result fields, and usage context. However, it omits the accepted sort values and the meaning/effect of page and size, which are required for an agent to invoke it correctly with multi-dimensional filtering.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is reported at 100% but the property descriptions are mere labels ('keyword', 'page', 'size', 'sort') with no real meaning. The description adds semantics for keyword ('输入关键词') and partially for sort ('按排序方式多维度筛选'), but page and size remain unexplained. This fits the baseline of 3 for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: searching Kuaishou works, specifically '热门作品(广域库)'. It enumerates the returned fields (title, author, play count, likes, comments, favorites) and the ability to jump to details and extract video content. This clearly separates it from sibling tools like kuaishou-account-works or kuaishou-comment.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use it: when the user needs to search Kuaishou works, find hot content, or query work data, and even lists trigger words. It lacks an explicit when-not-to-use or named alternatives, but the use case is clear enough to route an agent correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
kuaishou-video-extractA
快手视频文案提取(视频转文字),提交视频链接自动提取文案
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 快手视频链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full disclosure burden. It does disclose the core behavioral trait — the video-to-text transformation happens automatically upon link submission. However, it does not reveal the output format, whether transcription or subtitle extraction is used, processing constraints (e.g., video length, public access), or failure behavior, which matters more given zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that front-loads the core purpose, adds a clarifying parenthetical, and then gives the usage instruction. Every element earns its place with zero redundant wording.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool, the description adequately specifies the input and the action (link in, extracted copy out), which is enough for an agent to invoke it. However, with no output schema present, the description should ideally clarify what the returned text looks like (plain transcript vs. structured segments) and any limitations, leaving a moderate gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with the url parameter already described as "快手视频链接" (Kuaishou video link). The description adds the semantic that this link triggers automatic copy extraction, but it mostly echoes the schema rather than extending it, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: "提取文案" (extract copy) from "快手视频" (Kuaishou video), reinforced by the clarifying parenthetical "视频转文字" (video to text). This clearly differentiates it from sibling tools like kuaishou-account-works, kuaishou-comment, and the various platform video downloaders, none of which convert a video link into a transcript.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives a clear invocation pattern — "提交视频链接自动提取文案" (submit a video link to automatically extract copy) — establishing that this tool is used when the agent possesses a Kuaishou video URL and needs its text content. However, it never explicitly names alternatives or states when-not-to-use conditions, so the guidance is clear context without exclusion logic.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
multi-content-feedA
全网内容出海Top50榜单查询:按日期获取公众号/抖音/视频号/小红书/快手/B站内容出海爆款作品。平台编号:0公众号 1抖音 2视频号 3小红书 4快手 6B站;数据每日15:00更新前一天
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| keyword | No | 内容关键词(可选) | |
| platforms | No | 平台编号(逗号分隔,如 0,1,3;留空返回全部6平台) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations present, the description must carry behavioral disclosure on its own. It does add useful context: '数据每日15:00更新前一天' and the platform-number mapping. However, it does not disclose authentication needs, rate limits, default behavior when no date is provided, or the structure of the returned top-50 results. This is adequate but shallow for a tool with zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and well-structured: purpose first, then platform codes, then update cadence. Every sentence carries information relevant to invoking the tool correctly. It is slightly dense, especially with the platform-code list, but it avoids redundancy and front-loads the primary purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no output schema and no annotations, the description should compensate by clarifying return structure. It hints at results via 'Top50榜单' and '爆款作品', but doesn't specify whether the list is per-platform or combined, what fields are returned, or how keyword filtering affects results. The update schedule and platform list are valuable, but the absence of output details leaves noticeable gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but the description adds essential meaning for the 'platforms' parameter by mapping numeric codes to platform names (0公众号, 1抖音, 2视频号, 3小红书, 4快手, 6B站). The date and keyword parameters gain no additional explanation, but the platform-code mapping is a substantial enhancement over the bare schema. This lifts the score above the baseline of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with '全网内容出海Top50榜单查询', a specific verb (查询) and resource (Top50 list of content going overseas), and then enumerates the six covered platforms. This clearly distinguishes it from single-platform sibling tools like douyin-ai-feed or bilibili-keywords-search. The platform list and 'Top50榜单' scope make the tool's purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides context ('按日期获取', '数据每日15:00更新前一天') but gives no explicit when-to-use or when-not-to-use guidance. It does not mention alternatives or exclusion criteria, so an agent must infer from the multi-platform scope why this tool should be chosen over platform-specific siblings. This is a significant gap.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
multi-wordcheckB
多平台违禁词检测,检查文案中的敏感词并返回检测结果
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 待检测文案内容 | |
| platform | No | 目标平台 | xiaohongshu |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description bears the full burden. It only says 'returns detection results' without clarifying the output format, whether it blocks on sensitive words, or how multi-platform results are aggregated. This is a thin disclosure for an unannotated tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence that front-loads the core purpose. There is no wasted wording, though it is arguably too sparse to cover behavioral details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity of the two-parameter schema, the description is minimally adequate, but with no output schema and no annotation, the vague 'returns detection results' leaves the agent unsure of what the response looks like. More detail about multi-platform result structure would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both 'content' and 'platform' clearly described in the input schema. The description adds no new parameter-level meaning beyond what the schema already provides, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb (detect) and resource (prohibited/sensitive words in copy), and the 'multi-platform' qualifier differentiates it from single-platform siblings like xiaohongshu-prohibited-word, douyin-prohibited-word, and wechat-prohibited-word. However, it does not list which platforms are covered, so it stops short of being fully precise.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The word 'multi-platform' implies this tool is for checking across multiple platforms, but the description gives no explicit when-to-use guidance, no exclusions, and no mention of alternatives. Usage context is inferable but not stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
playlet-bili-feedA
B站短剧爆款榜查询:按日期获取B站短剧作品(点赞量排序)。数据每日15:00更新前一天,查询日期仅允许≤最近数据日且无数据日期必须确认后再查,禁止自动回退
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the disclosure burden. It reveals the daily 15:00 update schedule, the previous-day data lag, the strict date-validity rule, and the no-automatic-fallback behavior. It does not describe the output shape or error behavior, but those are secondary for a simple read-only feed query.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that front-loads the purpose and sorting behavior, then packs the important update and date rules without redundancy. Every phrase earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity tool with two optional parameters, a fully documented schema, and no output schema, the description provides all essential operational context: platform, content type, ordering, update cadence, and date constraints. Nothing critical is missing for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds meaningful semantics to the date parameter: it must not exceed the latest data date and no-data dates must be confirmed before querying. The count parameter receives no additional description beyond the schema, preventing a 5.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb-resource pair: query Bilibili short-drama hit-list works by date, sorted by likes. It distinguishes itself from sibling tools like playlet-douyin-feed and general bilibili search/download tools by naming both the platform (B站) and the content type (短剧爆款榜).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives explicit usage constraints: dates must be ≤ the latest data date, no-data dates require confirmation, and automatic fallback is prohibited. It does not explicitly name alternative tools when not to use it, but the sibling names and platform/content scoping make the selection context reasonably clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
playlet-douyin-feedA
抖音短剧爆款榜查询:按日期获取抖音短剧作品(点赞量排序)。数据每日15:00更新前一天,查询日期仅允许≤最近数据日且无数据日期必须确认后再查,禁止自动回退
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden and does disclose important behaviors: the daily 15:00 update schedule, the restriction on querying future dates, and the critical rule that dates without data require confirmation and cannot auto-fallback. This goes well beyond a generic query description, though it stops short of describing response format or error handling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single dense sentence front-loads the purpose and then adds only high-value behavioral constraints. Every clause carries operational information with no filler or repetition of schema fields.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter query tool with no annotations and no output schema, the description covers the essential calling semantics: what is returned, when data is fresh, and the non-obvious date/fallback rules. It doesn't describe the response shape, which would be useful given there is no output schema, but for invoking the tool correctly it is nearly sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already documents both parameters at 100% coverage, so the baseline is 3. The description adds genuine value for the date parameter by specifying data freshness semantics and the allowed range, plus the no-fallback rule. The count parameter is not enriched, but the overall parameter semantics are meaningfully improved.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('查询/获取') and resource ('抖音短剧作品'), and specifies the ordering ('点赞量排序') and filter ('按日期'). This makes the tool's core function clear and it can be distinguished from other playlet feeds by platform and content. However, it never explicitly names a sibling tool or states what it is not, so explicit differentiation is missing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives concrete operational constraints for the date parameter (must be ≤ latest data day, no automatic fallback, confirm no-data dates), which is useful. But it provides no guidance on when to choose this tool over sibling alternatives like playlet-bili-feed or douyin-daily-hot; the use case is only implied by the name and platform focus.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
playlet-wechat-feedA
公众号短剧爆款榜查询:按日期获取公众号短剧文章(阅读量排序)。数据每日15:00更新前一天,查询日期仅允许≤最近数据日且无数据日期必须确认后再查,禁止自动回退
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It reveals important behavior: daily update timing, strict date-boundary rule, and the no-auto-fallback policy. It doesn't describe response format or error behavior, but the key operational traits are disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single dense sentence with no filler. Every clause contributes either resource identification, sorting behavior, data freshness, or a constraint. The purpose is front-loaded and the constraints are compactly packed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter read-only feed query with no output schema, the description covers the resource, sort order, data freshness, date constraints, and the no-fallback rule. It doesn't enumerate return fields, but the nature of a ranked article list is reasonably inferable and not essential for invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents both date and count. The description adds meaningful semantic value for the date parameter: allowed range relative to the latest data day, update freshness, and the requirement to confirm no-data dates rather than silently fall back. Count is sufficiently covered by the schema alone.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource: 查询公众号短剧爆款榜 (query WeChat official-account short-drama hit list), and adds distinguishing attributes: by date, sorted by read count. This clearly differentiates it from sibling platform feeds like playlet-douyin-feed or cultural-tourism-wechat-feed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives concrete operational guidance: data updates at 15:00 for the previous day, query date must be no later than the latest data date, no-data dates must be confirmed before querying, and automatic fallback is forbidden. It doesn't explicitly name alternative tools or state when not to use this tool, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
playlet-xiaohongshu-feedA
小红书短剧爆款榜查询:按日期获取小红书短剧笔记(互动量排序)。数据每日15:00更新前一天,查询日期仅允许≤最近数据日且无数据日期必须确认后再查,禁止自动回退
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 数据日期 YYYY-MM-DD(默认最近数据日) | |
| count | No | 最大返回条数 1-200(默认100) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and discloses the key behaviors: the 15:00 update schedule, the date-validity boundary, and an explicit prohibition on automatic date fallback ('禁止自动回退'). The no-fallback rule is especially valuable because it stops an agent from silently substituting an earlier date. It does not disclose return format or error behavior, but the critical operational traits are covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with the tool's purpose front-loaded before its constraints. Every clause earns its place. The second sentence is dense, packing three constraints into one run-on clause, which slightly harms readability, but there is no wasted text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The trickiest aspects for correct invocation — update cadence, date validity, and the no-fallback rule — are well covered, and both parameters are fully documented in the schema. However, with no output schema, the description does not explain the return format or what the response contains beyond 'notes sorted by interaction', and the instruction '无数据日期必须确认后再查' is ambiguous about what 'confirm' means and with whom.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds genuine meaning beyond the schema by stating the date parameter's allowed range (≤ latest data date), the confirmation requirement for no-data dates, and the no-fallback rule — none of which appear in the schema's parameter descriptions. The count parameter is already fully documented by the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: query Xiaohongshu short-drama notes by date, sorted by interaction volume. The qualifiers '短剧' (short drama), '互动量排序' (interaction sort), and the platform name distinguish it from most siblings implicitly, though it never explicitly contrasts itself with similar tools like playlet-douyin-feed or xiaohongshu-dailytop.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear operational context: data updates daily at 15:00 for the previous day, dates must be ≤ the latest data date, and no-data dates require confirmation. However, it provides no guidance on when to choose this tool over the many similar siblings (playlet-bili-feed, playlet-douyin-feed, xiaohongshu-dailytop, xiaohongshu-ai-feed), so selection among alternatives is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
seedance-video-genA
AI视频生成工具,基于豆包 Seedance 2.0 模型,输入文字提示词生成视频(自动等待任务完成并返回视频链接)
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | 随机种子,-1为随机 | |
| ratio | No | 画面比例 | 16:9 |
| prompt | Yes | 视频内容描述提示词 | |
| duration | No | 视频时长(秒) | |
| imageUrl | No | 参考图片URL(图生视频) | |
| watermark | No | 是否带水印 | |
| resolution | No | 分辨率 | 720p |
| generateAudio | No | 是否生成音频 | |
| returnLastFrame | No | 是否返回最后一帧图片 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the disclosure burden. It does disclose an important runtime behavior: the tool automatically waits for the task to complete and then returns a video link. However, it does not mention potential wait duration, failure modes, pricing, or credit implications, so the disclosure is partial.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence with no filler. It front-loads the tool purpose, adds the model identity, and ends with the most operationally relevant behavior: waiting for completion and returning the link.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, and the description does state the return type: a video link. It also covers the key operational behavior of automatic waiting, which is the main uncertainty an agent would face. Detailed parameter choices are left to the fully described schema, so the description is sufficient even though it does not summarize image-to-video support.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds little parameter-level meaning beyond restating that text prompts are the input, and it omits the image-to-video capability obvious from the imageUrl parameter, though the schema already documents that.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action and resource: generate video from a text prompt using the Doubao Seedance 2.0 model. It clearly distinguishes this tool from the sibling set, which contains mostly downloaders, search tools, feed aggregators, and content writers rather than video generators.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context: use this tool when the agent needs to generate a video from a prompt. It does not explicitly name alternatives or when-not conditions, but no sibling tool appears to offer the same video generation capability, so an explicit exclusion is less critical.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
stock-analysisA
公众号A股大V文章查询:按公众号微信号获取其历史文章(发布时间倒序),供复盘/选股素材采集。内置大V微信号:猫笔刀maobidao、格兰投研gelantouyan、投资明见sinaxxm、财躺平gh_ad228eaec48a、终身黑白zshbtz
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | 回溯天数(发布窗口) | |
| offset | No | 分页偏移量 | |
| account | Yes | 公众号微信号(内置大V见描述,也支持任意公众号微信号) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the behavioral disclosure burden. It discloses that results are sorted by publish time descending and that arbitrary account IDs are supported. However, it does not describe output fields, pagination behavior, rate limits, or empty/failure cases.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded with the core purpose, followed by a useful built-in account list. No redundant sentences, though the account list makes it slightly long.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The parameter schema is complete and the description covers purpose, scope, sorting order, and valid account sources. However, with no output schema and no annotations, the return structure and pagination details are unspecified, leaving some ambiguity for the agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds value by listing concrete built-in account IDs for the required `account` parameter, giving the agent valid callable examples. The `days` and `offset` parameters are already fully described in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: querying historical WeChat official-account articles by account ID for A-share big-V accounts. It gives a specific verb-resource pair ('获取其历史文章') and includes concrete built-in account IDs, which distinguishes it from sibling search, feed, and top-list tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear usage context: it is for review/stock-picking material collection and should be used when querying articles by WeChat account ID. It also clarifies support for arbitrary account IDs, but it does not explicitly name alternatives or state when not to use this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
stock-feedC
股票内容资讯查询,跨平台搜索股票相关爆款内容
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| keyword | Yes | 搜索关键词(如股票代码或名称) | |
| platforms | No | 平台列表(逗号分隔) | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It signals read-only behavior via '查询' and an output focus on '爆款内容', but it does not disclose return format, platform coverage, pagination, freshness, or limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One sentence with no filler and the core operation front-loaded. There is mild redundancy between '股票内容资讯查询' and '跨平台搜索股票相关爆款内容', but it remains concise and scannable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has no annotations and no output schema, so the description should explain what the returned content looks like and which platforms are included. It only says 'content info query' and 'viral content', leaving the agent to guess return structure and cross-platform scope.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds no parameter-specific detail beyond the stock-content theme; it does not clarify platform values, date formats, or keyword behavior beyond what the schema already states.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific operation: querying stock-related news/content and cross-platform search for viral stock content. It distinguishes itself from platform-specific feed siblings and stock-analysis, though it does not explicitly name an alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use or when-not-to-use guidance is provided. The cross-platform phrasing implies one usage context, but with many similar search/feed siblings, there is no explicit comparison or exclusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
tiktok-video-downloaderB
根据视频链接下载TikTok视频
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | TikTok视频链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only restates the core action of downloading a video and gives no details about output format, whether it returns a file path or URL, potential failures, authentication requirements, or platform restrictions. This is a significant transparency gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single front-loaded sentence with no wasted words; it directly communicates verb, object, and input. However, it is somewhat terse and borderline under-specified, which keeps it just below a perfect score.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple single-parameter tool, the description is minimally adequate: the action and the required input are clear. But with no output schema and no annotations, the tool's expected result or behavior after invocation is not explained, leaving an agent to guess what the response will contain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already has 100% coverage with the parameter description 'TikTok视频链接', so the baseline is 3. The description adds no additional parameter meaning beyond reinforcing that the URL must be a TikTok video link; it does not clarify allowed URL formats or whether share links are accepted.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('下载' / download), a specific resource ('TikTok视频'), and the input condition ('根据视频链接' / based on a video link). It clearly differentiates from sibling video downloaders for other platforms like bilibili, youtube, or xiaohongshu by naming TikTok explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use the tool: when a user provides a TikTok video link and wants it downloaded. However, it provides no explicit guidance about when not to use it, nor does it reference any alternative sibling tool, so the usage context is only implied rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
toutiao-searchC
今日头条作品搜索,按关键词查询头条爆款内容
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | 偏移量 | |
| keyword | Yes | 搜索关键词 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are absent, so the description carries the full burden of behavioral disclosure, and it is thin. It discloses only that this is a keyword-based search, with no mention of pagination semantics (despite the offset parameter), result scope/filtering behavior, rate limits, or whether '爆款' is an actual filter or aspirational phrasing. The description neither confirms nor clarifies what happens when the search executes.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single front-loaded sentence: platform first, then the action and query method. Every element earns its place, and there is zero filler. It could have used the saved space for behavioral context, but as a concise and well-ordered definition it is effective.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity tool with two flat parameters, the description is adequate for basic invocation — an agent can determine it needs a keyword and can call the tool. However, with no output schema and no annotations, the missing return-format and pagination details are meaningful gaps, and the ambiguous '爆款内容' phrasing adds uncertainty about what results to expect.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (both offset and keyword have Chinese descriptions), so the baseline is 3. The description's '按关键词查询' corroborates the keyword parameter's role but adds no new meaning; it does not explain the offset parameter's pagination behavior or any keyword formatting constraints, leaving agents with only the terse schema text.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb (搜索/search), a resource (今日头条作品/Toutiao works), and a method (按关键词/by keyword), making the core purpose clear. The platform designation '今日头条' distinguishes it from the many sibling platform-search tools (douyin-search, kuaishou-search, wechat-search, etc.). However, '爆款内容' (viral content) creates slight ambiguity about whether the tool searches all Toutiao content or only filters for trending/viral items.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use toutiao-search versus alternatives. With roughly a dozen sibling search tools (weibo-post-search, wechat-search, xiaohongshu-search, deepseek-websearch, doubao-websearch, etc.), the description does not state which platform scenarios map to this tool, when not to use it, or how it differs from general web-search siblings. An agent must infer platform selection purely from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
trending-hubC
全网热点聚合查询,按平台和关键词获取热门话题
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| keywords | No | 关键词(逗号分隔) | |
| platform | No | 平台:douyin/xiaohongshu/weibo 等 | douyin |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It implies a read-only aggregation query, but it does not describe return shape, default behavior when no parameters are supplied, whether date ranges are required, or any operational constraints. This is minimal and insufficiently transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no filler. There is slight redundancy between '热点' and '热门话题', but overall it is compact and scannable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no annotations, no output schema, and many closely related siblings, the description is too thin. It omits expected output format, default behavior, differentiation from hot-topic alternatives, and operational caveats. Parameter documentation is complete, but that alone does not make the tool contextually complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description's mention of platform and keywords reinforces the schema but adds no new semantic detail beyond what each parameter already documents.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a query/retrieval operation ('查询'/'获取') applied to a resource ('全网热点'/'热门话题') with explicit filters ('平台和关键词'). It is clear enough to distinguish from platform-specific hot-topic tools, but it does not explicitly differentiate itself from closely related siblings like trending-hub-top10.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to prefer this tool over alternatives such as trending-hub-top10, douyin-daily-hot, or weibo-hot-search. It does not state exclusions, prerequisites, or typical use cases, which is a notable gap given the large set of sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
trending-hub-top10C
全网热搜关键词 TOP10 查询
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only indicates a read-only 'query', but does not disclose whether date parameters are required, what happens when they are omitted, how the TOP10 is determined, or any ranking/period behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence with no filler and the core scope is front-loaded. It is concise and easy to parse, though its brevity contributes to gaps covered in other dimensions.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no output schema and no annotations, the description leaves an agent without return-format context, date-range behavior, or any caveats about how the TOP10 is computed. It is enough to identify the tool's purpose, but not fully sufficient for correct invocation in nuanced user requests.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both startDate and endDate described as date strings in YYYY-MM-DD format. The description adds no additional parameter semantics, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific operation ('查询' / query) over a clear resource ('全网热搜关键词 TOP10'). It clearly identifies the tool as a cross-network top-10 hot-search keyword query, though it does not explicitly distinguish it from the sibling tool 'trending-hub' or other platform-specific hot-search tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'trending-hub', 'weibo-hot-search', or 'douyin-daily-hot'. The only implicit usage signal is the '全网' scope, but no exclusions or selection criteria are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
twitter-commentC
X(Twitter)推文评论查询
| Name | Required | Description | Default |
|---|---|---|---|
| tweetId | Yes | 推文ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description must carry the full behavioral burden. It only says 'query', implying a read operation, but does not disclose return format, pagination, authentication needs, or rate limits. This is minimal and leaves important behavior unspecified.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact phrase with no filler, and the platform/resource are front-loaded. It is efficient, though slightly under-structured as a noun phrase rather than a complete sentence.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description should explain what the tool returns (e.g., comment list, fields, pagination) but does not. It also gives no usage context beyond the basic query, so an agent cannot fully anticipate the result or invocation requirements.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage and describes tweetId as '推文ID', so the description adds little beyond the schema. The baseline of 3 applies because the sole parameter is already documented and no extra format or constraint is clarified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action (query) and resource (tweet comments on X/Twitter), and explicitly names the platform, which helps distinguish it from siblings like youtube-comment or kuaishou-comment. It does not mention the required tweetId parameter, but the core purpose is identifiable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The description does not mention sibling comment tools or give conditions such as 'use this for X/Twitter comments' or 'for other platforms use youtube-comment/kuaishou-comment.'
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
twitter-video-downloaderA
根据推文链接下载X(Twitter)视频
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | X(Twitter)推文链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the core behavior but does not reveal what the tool returns (direct video URL, file path, success message), whether it creates side effects on disk, any authentication needs, or how invalid or non-video tweets are handled. This leaves significant behavioral ambiguity.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One short, front-loaded sentence with no filler. It immediately communicates the action, target platform, and input requirement. Perfectly sized for a simple single-purpose tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has one well-documented parameter and a straightforward action, making the input requirement complete. However, since there is no output schema and no annotations, the description does not explain the return value or output contract, leaving some ambiguity for the agent about interpreting the result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%: the single parameter 'url' is already described as 'X(Twitter)推文链接' (X/Twitter tweet link). The tool description merely restates this concept ('根据推文链接') without adding new semantic meaning, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb (下载/download), a specific resource (X(Twitter)视频/X(Twitter) video), and the required input condition (根据推文链接/from a tweet link). This clearly distinguishes it from sibling downloaders for Instagram, TikTok, YouTube, and other platforms.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended usage is implied by the name and description: use this tool to download a video from an X/Twitter tweet link. However, there is no explicit guidance on when to use it versus alternatives, no exclusions (e.g., unsupported URL types), and no prerequisites such as public visibility or specific tweet URL formats.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
video-prompt-expertC
帮助用户编写专业级 AI 视频提示词,写完直接生成 MP4 视频。支持多种创作场景与问题诊断,确保提示词准确可执行。触发词:视频提示词、视频生成提示词、AI视频创作、写视频提示词、导演指令、文生视频提示词、视频脚本、生成视频
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | seed | |
| model | No | model | |
| ratio | No | ratio | |
| content | No | content | |
| duration | No | duration | |
| watermark | No | watermark | |
| resolution | No | resolution | |
| generateAudio | No | generateAudio | |
| returnLastFrame | No | returnLastFrame | |
| executionExpiresAfter | No | executionExpiresAfter |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden and does disclose the core flow: compose a prompt, then generate an MP4, plus problem diagnosis. However, it omits important traits such as whether generation is synchronous, how results are returned, or any limits/costs, so transparency is only moderate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and front-loads the main purpose, but the trigger-word list is redundant for an API tool definition and the '多种创作场景与问题诊断' sentence is vague filler. It is not bloated, but not every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 10 optional parameters, no output schema, and no annotations, the description is far too thin to let an agent know how to construct a valid call or what to expect in return. It provides no details on parameter effects, return format, or failure modes.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although the schema coverage is nominally 100%, every parameter description merely repeats the parameter name (e.g., 'seed', 'model'), providing no real meaning. The tool description adds no guidance on valid values, units, or how optional parameters like ratio, generateAudio, or executionExpiresAfter should be used.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool writes professional AI video prompts and directly generates MP4 videos, which is a specific verb+resource combination. It also mentions multiple creative scenarios and problem diagnosis, giving a clear sense of scope, though it does not explicitly distinguish itself from sibling generation/writing tools like seedance-video-gen.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists trigger words and says it supports multiple creation scenarios, implying broad applicability, but it gives no explicit guidance on when to prefer this tool over the many sibling video/writing tools. There are no stated exclusions, prerequisites, or alternative routing conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
visual-ops-writerA
AI图片生成工具(视觉运营文案配图),提交文字提示词生成图片,支持参考图、批量风格(自动等待任务完成)
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | 图片尺寸,如 1024x1024 / 1792x1024 / 1024x1792 等 | 1792x1024 |
| style | No | 生成风格:redfox=红狐视觉风格, popcomic=流行漫画, yellowcomic=黄漫, reference=参考图风格, none=无风格 | redfox |
| prompt | Yes | 图片内容描述提示词 | |
| referenceImage | No | 参考图片URL(style=reference 时使用) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral disclosure burden. It does disclose one important trait: '自动等待任务完成' (automatically waits for task completion), which tells the agent the tool handles asynchronous work internally. However, it does not mention failure behavior, rate limits, costs, or what happens when a reference image is invalid, so behavioral disclosure is only partial.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence with purpose front-loaded, followed by key capabilities and the auto-wait behavior in parentheses. There is no filler, no repetition of the tool name, and every clause contributes useful information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 4-parameter tool with no output schema, the description frames the operation adequately but leaves gaps: it does not specify the return shape, clarify the dependency between style=reference and referenceImage, or explain whether '批量风格' means multiple outputs in a single call. The schema covers parameter syntax well, but the absence of an output schema raises the need for more behavioral context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all four parameters, including style enum meanings and referenceImage usage. The description adds only high-level feature hints like '参考图' and '批量风格' but does not clarify whether referenceImage becomes required when style=reference or how batch styles are represented in a call.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb-resource pair: '提交文字提示词生成图片' (submit a text prompt and generate an image), and adds the use case '视觉运营文案配图'. It is unambiguous as an image-generation tool, but it does not explicitly name or differentiate from sibling tools like seedance-video-gen, so it stops just short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use it ('视觉运营文案配图' for visual operations copy illustrations) and how to use it ('提交文字提示词生成图片'), but it gives no explicit when-not-to-use guidance or alternatives. The usage context is clear enough to infer, but exclusions are absent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-10w-hotB
公众号10w+爆文查询,按分类和时间获取10w+阅读热门文章
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 分类:总排名/科技数码/健康养生 等23个标准分类 | 总排名 |
| endDate | Yes | 结束日期 YYYY-MM-DD | |
| startDate | Yes | 起始日期 YYYY-MM-DD(支持 yesterday 等) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It does convey a read-only lookup of 100k+ read articles filtered by category and date, but it does not disclose result format, result limits, sorting behavior, or handling of invalid date/category values.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one short sentence with the main action front-loaded and no filler. It is slightly redundant in that '公众号10w+爆文查询' and '获取10w+阅读热门文章' restate the same core idea, but this is minor.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple 3-parameter query tool, the core inputs and selection criteria are documented. However, with no output schema and no annotations, the description still leaves the agent without a clear picture of the return payload or any usage constraints, so it is only minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description only repeats the 'by category and time' idea already present in the parameter schema and adds no additional format, relationship, or default-value context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific action (查询/获取) and resource (公众号10w+爆文/10w+阅读热门文章) and states the key filtering scope: category and time. It is clearly distinguishable from WeChat sibling tools by the '10w+' threshold and category/time focus.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no when-to-use guidance, no exclusions, and no mention of alternatives. Among many related WeChat tools, the agent is left to infer when this tool should be chosen over tools like wechat-original-hot or wechat-search.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-channels-ai-feedA
AI视频号信息源 — 每日自动扫描视频号 AI 相关作品,按互动量(点赞/分享/评论)筛选最火内容,智能聚类生成精美 HTML 日报,支持封面图、数据指标和每日订阅。当用户需要 AI 视频号日报、视频号AI热点、AI视频号内容、视频号信息源时使用。
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | keyword | |
| pageNum | No | pageNum | |
| pageSize | No | pageSize |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden. It discloses meaningful behavior: daily automatic scanning, engagement-based filtering, clustering, HTML report generation, cover images, metrics, and daily subscription. It does not discuss side effects or output structure, but the described behavior is substantial and non-misleading.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single well-structured sentence that front-loads the core function, lists key features, and ends with explicit usage triggers. Every part earns its place, and there is no redundant or filler wording.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description conveys the tool's high-level behavior and use case, but with no output schema and no parameter semantics, an agent still has to infer how to supply keyword, pageNum, and pageSize. It also does not explicitly contrast this tool with very similar siblings such as wechat-channels-crawler or the other ai-feed tools, leaving some selection ambiguity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. However, the schema descriptions are near-tautological ('keyword', 'pageNum', 'pageSize'), and the tool description adds no parameter-specific guidance about what keyword should contain or how pagination interacts with the daily report. The parameter names are self-explanatory to a degree, but the description does not enrich them.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific verb and resource: it automatically scans WeChat Channels for AI-related works, filters by engagement metrics, clusters them, and generates an HTML daily report. This makes the tool's purpose concrete and distinguishes it from generic siblings like wechat-channels-crawler or platform-specific feeds such as douyin-ai-feed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit trigger conditions: use when the user needs AI video account daily reports, AI hotspots from video accounts, AI video account content, or a video account information source. It does not explicitly name alternatives or when not to use, but the context is clear enough for an agent to select this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-channels-crawlerA
视频号作品查询工具。根据用户输入的关键词搜索视频号热门作品,支持按最新、最多点赞、最多收藏和综合排序,结果以结构化表格展示。当用户想要查找视频号热门内容、搜索视频号爆款视频、查询视频号作品数据、了解某类内容在视频号的表现时使用。触发词包括:视频号搜索、视频号作品查询、视频号爆款、视频号热门、视频号内容搜索、搜视频号、微信视频号搜索。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | page | |
| size | No | size | |
| sort | No | sort | |
| keyword | Yes | keyword |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the disclosure burden. It reveals that the tool searches by keyword, supports multiple sort orders, and returns results as a structured table. However, it does not mention pagination behavior, data limits, freshness, or any constraints of the crawler.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well organized: it opens with the tool's core purpose, then explains supported behavior and output, followed by clear use cases and trigger words. The trigger-word list adds routing value without being overly verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema and no annotation coverage, so the description must fully explain how to call the tool correctly. It leaves page/size semantics unspecified, does not map sort modes to parameter values, and only vaguely describes the return as a structured table.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but each parameter description is tautological ('keyword', 'sort', 'size', 'page'). The description adds meaning for keyword and sort dimensions, but it does not specify exact sort values or the units/ranges for page and size.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: searching WeChat Channels (视频号) works by keyword, with sorting modes and structured table output. It is distinguishable from generic wechat-search by focusing specifically on Channels video data, though it does not explicitly name sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit when-to-use scenarios: finding hot content, searching viral videos, querying video data, or understanding content performance on WeChat Channels. It includes trigger words to help route intent, though it does not state when not to use it or name alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-coverB
公众号爆款封面参考,查询同赛道爆款文章获取封面设计参考
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 赛道关键词 | |
| maxItems | No | 返回数量 | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It suggests a read/query operation and mentions returning '封面设计参考', but it does not clarify whether the output contains actual cover images, article links, design suggestions, or other data, nor does it disclose any limitations or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that front-loads the core purpose. It loses a point because '爆款封面参考' and '封面设计参考' are somewhat redundant, but overall it is compact and easy to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description should explain what the caller receives. It only says the tool provides cover-design reference, leaving the return structure, item format, and any default behaviors unclear. The schema documents parameters adequately, but the overall context is incomplete for confident invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents keyword, maxItems, and startDate. The description adds little beyond echoing the 'same niche' concept from the keyword parameter and does not explain the format or interaction of startDate or maxItems, so a baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('查询' / query), a specific resource (公众号爆款文章 / viral WeChat official-account articles), and a clear purpose (获取封面设计参考 / obtain cover-design references). It distinguishes this tool from WeChat search/write tools by focusing on cover design, though it does not explicitly name sibling alternatives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use the tool: when the user needs cover-design reference from viral articles in the same niche ('同赛道爆款文章'). However, it gives no explicit guidance on when not to use it or which alternative tools to prefer, such as wechat-search or xiaohongshu-cover.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-fastest-growingA
公众号阅读增长最快账号榜,按日期查询(每日更新,仅支持最近30天)
| Name | Required | Description | Default |
|---|---|---|---|
| rankDate | Yes | 榜单日期 YYYY-MM-DD(最近30天,支持 yesterday/today) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses useful behavioral constraints—daily updates and the 30-day window—but it does not describe output ordering, result fields, or behavior for invalid dates. Since there is no output schema, this leaves some uncertainty about the returned structure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single compact sentence communicates the resource, the query method, update frequency, and time restriction with no filler. It is well-structured and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity, one-parameter read-only ranking tool, the description plus schema is sufficient for an agent to know what to call and how to pass rankDate. Slightly more detail about the returned ranking fields would make it fully complete given the absence of an output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the schema already documents the date format, the 30-day limit, and the yesterday/today aliases. The description only restates date-based lookup and the 30-day restriction, adding no new parameter meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific resource—公众号阅读增长最快账号榜 (WeChat official account reading-growth ranking)—and a clear query mode (按日期查询). This distinguishes it from sibling tools like wechat-top-account and wechat-10w-hot, since it is specifically about accounts with the fastest reading growth.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear usage context: query by date, updated daily, and only supports the last 30 days. It does not explicitly name alternatives or state when not to use the tool, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-original-hotB
公众号原创爆款文章查询,按分类和时间获取原创10w+文章
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 分类:总排名/科技数码/健康养生 等23个标准分类 | 总排名 |
| endDate | Yes | 结束日期 YYYY-MM-DD(后端强制必填) | |
| startDate | Yes | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It does communicate a read-only intent through '查询' and '获取' and specifies the 10w+ article filter, which is useful. However, it does not disclose return format, ordering, pagination, or any limits, leaving meaningful behavioral aspects unaddressed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, short sentence that is easy to scan and front-loads the main purpose. There is mild redundancy between '查询' and '获取' and between '爆款' and '10w+', but the second clause does add the key filtering criteria, so the overall structure is acceptable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no output schema and no annotations, the description gives a reasonable high-level understanding but omits return value expectations, sorting, and result limits. The schema covers required parameters adequately, so invocation is possible, but an agent is left with uncertainty about what data will be returned and how it is structured.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds only a general confirmation that results are filtered by category and time; it does not explain parameter purpose beyond what the input schema already states. The type parameter's allowed values remain vague ('等23个标准分类') in both the schema and the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific action—querying official-account original viral articles—and identifies the resource ('公众号原创爆款文章') plus the filtering dimensions (category and time). However, it does not differentiate this from the similarly named sibling 'wechat-10w-hot', which appears to target the same kind of data, so it stops short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description tells what the tool does but gives no explicit guidance on when to use it instead of sibling tools like 'wechat-10w-hot' or 'wechat-fastest-growing'. There is no mention of trade-offs, exclusions, or conditions that should route an agent to this tool versus alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-prohibited-wordA
公众号违禁词检测,检查文案中的敏感表述
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 待检测文案内容 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It conveys the core read-only behavior of checking content for sensitive expressions, but it does not disclose what the tool returns, whether it lists offending words, or any limitations such as false positives or coverage scope.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and front-loaded with the core purpose. However, the second clause '检查文案中的敏感表述' partially restates the first clause, making it slightly redundant even though it adds a bit of nuance about sensitive expressions.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema and no explanation of what the tool returns, such as whether it returns a pass/fail result, a list of prohibited words, or a risk score. Since annotations are absent, the description needed to cover the return value expectations but did not, leaving the tool incomplete for an agent that must interpret results.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the parameter 'content' is already documented as '待检测文案内容'. The description adds only marginal context by calling the input '文案', which aligns with the schema but does not add new constraints like length limits, language, or formatting expectations.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: '检测'/'检查' applied to '公众号违禁词' (WeChat official account prohibited words). It clearly distinguishes itself from sibling platform-specific tools like xiaohongshu-prohibited-word and douyin-prohibited-word by naming the 公众号 platform.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The usage context is implied through the platform name: use this tool for detecting prohibited words in WeChat official account copy. However, the description does not explicitly state when not to use it or mention alternatives such as douyin-prohibited-word or xiaohongshu-prohibited-word.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-rewriteB
一位公众号爆款文案撰写专家。具有硬核的公众号文案功底,不管给你什么文案,你总能把该文案转化为一篇高阅读数的公众号文案,文案中必定会包含一些具有公众号特色的词汇。这个角色需要具备精通语言的能力,这个角色的任务是通过语言的艺术表达,使句子更加生动、吸引人、有趣和具有说服力。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Since no annotations are provided, the description carries the full burden of behavioral disclosure. It states that the tool will inject WeChat-featured vocabulary and make sentences more vivid, attractive, interesting, and persuasive. However, it stays at a persona level and omits operational details like input handling, output format, or limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a flowery persona paragraph with noticeable redundancy: '具有硬核的公众号文案功底' and '需要具备精通语言的能力' overlap, and the same role/task framing is repeated. It front-loads the core idea but spends too many words restating it.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple no-parameter generative tool, the description conveys the essential behavior and output style. However, it does not clarify how the source copy is provided or what the tool returns, which creates mild ambiguity given the empty schema and absence of an output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has zero parameters, so there is nothing for the description to add beyond the empty schema. Per the baseline for 0-parameter tools, this deserves a 4; there is no ambiguity or unmet need.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies a specific action: transforming existing copy into high-readership WeChat official account copy with platform-specific stylistic traits. It implicitly distinguishes itself from siblings like wechat-write (new copy) and xiaohongshu-rewrite (different platform), though it does not name them explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool is for rewriting copy into WeChat viral style, but it provides no explicit when-to-use or when-not-to-use guidance, nor does it route to alternatives such as wechat-write or platform-specific rewriters. Usage is inferable but not directly stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-searchB
公众号文章搜索,按关键词搜索公众号爆款文章
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 搜索关键词 | |
| maxItems | No | 返回数量 | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral disclosure burden. It only restates the search action and does not mention result ordering, pagination, rate limits, freshness, caching, or what qualifies as '爆款', leaving the tool's runtime behavior opaque.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence with no filler and is easy to scan. It has slight redundancy because '公众号文章搜索' and '公众号爆款文章' overlap, but it remains efficient and front-loads the resource and action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has a simple input schema and no output schema or annotations, so the description should at least hint at the return value and behavior. It does not explain what the output looks like, what '爆款' means, or how maxItems and startDate affect results, leaving an important gap for the agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents keyword, maxItems, and startDate. The description adds minimal semantic context by mentioning '关键词' and '爆款文章', but it provides no extra detail about maxItems or startDate beyond what the schema already states.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action ('搜索') and resource ('公众号文章'), and narrows it to '爆款文章', so an agent can tell this is a keyword-based article search. It does not explicitly differentiate from sibling tools like wechat-10w-hot or wechat-original-hot, but the core purpose is still unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase '按关键词搜索' implies the tool is for keyword-driven searches, which gives some usage direction. However, there is no explicit guidance on when to prefer this tool over sibling search or hot-list tools, and no alternatives or exclusions are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-similar-accountA
公众号创作者对标账号匹配工具,基于3层加权匹配体系(核心基础40%+运营变现35%+数据特征25%)推荐对标账号和头部账号。当用户需要公众号账号推荐、公众号对标、起号参考、账号投放选择时使用。触发词:公众号对标、相似账号、对标推荐、起号参考、账号匹配。
| Name | Required | Description | Default |
|---|---|---|---|
| accountId | No | accountId | |
| accountName | No | accountName | |
| accountType | No | accountType |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden. It contributes useful transparency by revealing the 3-layer weighted matching system (40%/35%/25%) and implying a non-destructive recommendation behavior. Still, it omits output shape, failure scenarios, or data-source expectations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loads the purpose before explaining the algorithm and use cases. The trigger-word list is somewhat redundant, but it does not bloat the description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is incomplete for invocation: all three parameters are optional, none are semantically explained, and no output schema or return-value guidance exists. An agent can determine when to use the tool but not confidently know what inputs to provide or what response to expect.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema descriptions are tautological ('accountId', 'accountName', 'accountType') and accountName is typed as a number, which is likely misleading. The tool description does not explain how these parameters map to the matching logic, which parameter should be supplied, or whether a specific identifier is required. Despite the reported 100% schema coverage, the actual semantic guidance is negligible.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a WeChat Official Account benchmark/similar-account matching tool and specifies what it recommends: benchmark accounts and top accounts. It also states the matching mechanism, making it easy to distinguish from platform-specific siblings like douyin-similar-account and xiaohongshu-similar-account.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly lists concrete use cases: account recommendation, benchmarking, account-starting reference, and placement selection, plus trigger words. However, it does not mention when not to use the tool or explicitly contrast it with alternative similar-account tools, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-titleA
公众号爆款标题参考,按关键词查询近N天同赛道爆款文章标题规律
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | 查询最近N天(1-30,默认7) | |
| keyword | Yes | 赛道关键词(多词用逗号分隔,最多5个) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations and no output schema, the description carries the disclosure burden. It does communicate that this is a lookup ('查询') scoped to '近N天' and '同赛道爆款文章', and that the result is '标题规律', but it leaves the concrete output shape, ordering, and pagination unspecified.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence front-loads the platform and purpose ('公众号爆款标题参考') and then gives the query mechanism and scope. There is no filler and nothing that duplicates the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter lookup, the description plus schema covers invocation essentials. However, without an output schema and with only the vague '标题规律' as the promised result, an agent cannot fully anticipate the response shape.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3; the schema already documents keyword as '赛道关键词' and days as '查询最近N天'. The description adds minor context about '同赛道爆款文章' but no new format, constraints, or semantics beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description identifies a specific action ('按关键词查询') and resource ('公众号爆款标题参考' / '标题规律'), making clear it is a WeChat Official Account title-pattern lookup. It implicitly separates this from write/rewrite/search siblings, but does not explicitly name an alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied: the tool should be used when the agent needs viral title patterns for WeChat articles in a niche within a recent window. However, there is no explicit when-to-use/when-not-to-use statement and no mention of alternatives such as wechat-write, wechat-rewrite, or xiaohongshu-title.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-top-accountB
公众号综合实力账号榜,按榜单类型与日期查询头部账号(日榜限近7天/周榜限近3周/月榜限近3月)
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | 分类(默认:总排名;可选 科技数码/健康养生 等23个标准分类) | 总排名 |
| rankDate | No | 榜单日期 YYYY-MM-DD;不填自动取该类型最近可用日期 | |
| rankType | No | 榜单类型:day=日榜(每日17:30更新昨日) week=周榜(周一更新上周) month=月榜(每月3号更新上月) | day |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations present, the description carries the full burden of behavioral disclosure. It does add a meaningful non-obvious constraint: daily lists only cover the last 7 days, weekly the last 3 weeks, and monthly the last 3 months. However, it does not say what happens for out-of-range dates, how results are ordered, or what fields the returned account entries contain.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with the action front-loaded. The parenthetical packs the three date-limit rules concisely without excessive detail. Every element earns its place, and there is no redundancy with the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read-only query tool with all optional parameters, the description plus a fully documented schema is mostly sufficient for invocation. The main gap is the absence of an output schema and any description of what fields a 'top account' entry includes (e.g., rank, account name, index score), so an agent may not know what to expect in the response.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description goes beyond the schema by linking rankType to valid rankDate ranges ('日榜限近7天/周榜限近3周/月榜限近3月'), a cross-parameter constraint that neither the rankType nor rankDate schema descriptions fully encode. This added semantic is genuinely valuable for correct invocation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('查询'/query), a clear resource ('公众号综合实力账号榜' / WeChat Official Account comprehensive strength ranking), and a scope (top accounts by rank type and date). This makes the tool's purpose intelligible. It does not explicitly name sibling tools it is not, but the '综合实力' (comprehensive strength) framing distinguishes it from other WeChat ranking tools like wechat-10w-hot or wechat-fastest-growing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no explicit guidance on when to use this tool versus alternatives among the many WeChat-related siblings. The description implies it is for comprehensive-strength rankings, but it never states exclusions like 'for fastest-growing accounts use wechat-fastest-growing' or 'for trending articles use wechat-10w-hot'. Usage context is left entirely to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-video-downloaderB
根据链接下载视频号视频
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 视频号链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, but it only states the download action. It does not describe the return value, whether saving/auth is involved, or failure modes, which leaves a substantial gap for an agent that must predict the tool's behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single short sentence with no filler; the action and resource are front-loaded. It is appropriately concise for a one-parameter tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the low complexity, the description omits what the tool returns after downloading and any conditions on the link (e.g., accessibility or authorization). With no output schema and no annotations, an agent does not have enough information to know how to interpret the call result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%: the url parameter is already described as '视频号链接'. The description adds no further meaning about link format, examples, or constraints, so a baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb (下载/download) and a specific resource (视频号视频/WeChat Channels video), making the tool's purpose immediately clear. This also distinguishes it from sibling video downloaders for other platforms such as instagram-video-downloader and youtube-video-downloader.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given about when to choose this tool over alternatives like wechat-channels-crawler or the other platform-specific downloaders, and no prerequisites or exclusions are stated. The only hint is the implicit condition of having a 视频号 link, which is already visible from the required url parameter.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wechat-writeB
公众号爆款文章写作参考,基于关键词查询同赛道爆款文章供创作参考
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 创作方向关键词 | |
| maxItems | No | 返回数量 | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It usefully clarifies that despite the 'write' name, the tool is a read-oriented query/reference tool, not a publishing or rewriting tool. It does not disclose output structure, sort order, or whether full article content or just metadata is returned.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one compact, front-loaded sentence that states the purpose before the mechanism. Minor redundancy between '写作参考' and '供创作参考' exists, but it does not hurt readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple keyword-based lookup tool, the description plus fully documented schema is workable: an agent knows to pass a keyword and can infer results are viral articles for reference. However, without an output schema, it would benefit from specifying whether results include titles, links, content snippets, or engagement metrics.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the parameters are already documented. The description adds little beyond rephrasing 'keyword' as the creative direction, but does not need to compensate for missing schema documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a WeChat Official Account viral-article writing reference that queries same-track hit articles by keyword. This distinguishes it from general search or rewriting tools, though it does not explicitly name a sibling alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase '供创作参考' implies the tool should be used during content creation to gather inspiration from viral articles. However, it gives no explicit when-to-use, when-not-to-use, or alternative tool guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weibo-comment-searchA
微博博文评论查询,支持翻页
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | 翻页游标,翻页时传上次返回的 maxCursor | |
| weiboId | Yes | 微博博文链接或 opusId(如 https://weibo.com/1784473157/R8X4f2lnq) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden. It does state that pagination is supported ('支持翻页'), which is relevant, but it does not describe the returned data shape, rate limits, or any read-only/safety guarantees beyond the implication of the word '查询'.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and front-loaded: the core operation comes first, and the pagination behavior follows. There is no filler or redundancy, and every part of the sentence adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter query tool, the description plus the fully documented schema is mostly sufficient for basic invocation. However, with no output schema and no annotations, the agent receives no description of what the response contains or the pagination loop contract beyond the schema's cursor reference.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both weiboId and cursor are already well documented in the input schema. The description adds only a general pagination note and does not materially extend the parameter semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific operation ('查询' comment) on a specific resource ('微博博文评论'), and it clearly distinguishes this tool from siblings like weibo-post-search and weibo-hot-search. It also adds the pagination capability, making the tool's purpose immediately understandable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives such as weibo-post-search, weibo-hot-search, or other platform comment tools. The description does not mention any use conditions, exclusions, or when not to use the tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weibo-hot-searchC
微博热搜榜查询
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of behavioral disclosure. It implies a read-only query through '查询', but it does not state what kind of data is returned, whether the list is current/historical, or what limitations exist. This is minimal behavioral signal, not substantive transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and has no wasted words, which is good. However, it is barely more than a restatement of the tool name and is underspecified as a usage explanation, so its brevity comes at the cost of informative content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a no-parameter tool, invocation may be trivial, but the description does not explain what the output is or how this differs from weibo-realtime-search. Without an output schema or annotations, '微博热搜榜查询' is too thin for an agent to confidently select and interpret the result of this tool over similar Weibo-related siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters and the schema coverage is effectively complete, so there are no parameter semantics the description needs to clarify. With 0 params, the baseline is 4, and the description does not need to compensate for any schema gaps.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '微博热搜榜查询' clearly identifies the verb (查询/query) and resource (微博热搜榜/Weibo hot search ranking). It is understandable on its own, but it does not explicitly differentiate itself from the sibling weibo-realtime-search, which could plausibly cover similar ground.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given about when to use this tool instead of related siblings such as weibo-realtime-search, weibo-post-search, or weibo-comment-search. The description simply states what the tool does without offering selection criteria or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weibo-post-searchC
微博用户作品列表查询
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| userId | Yes | 微博用户ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
没有任何 annotations,描述承担了全部行为披露责任,但它只说“查询列表”,没有说明返回内容、分页行为、是否需要登录/授权、是否有频率限制或副作用。对于一个只读查询工具,这虽然是轻量操作,但信息仍然不足。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
描述只有一句话且没有冗余词,信息密度高,作为标题式说明非常紧凑。但它是名词短语而非完整句式,缺少必要的扩展解释,因此未达到满分。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
工具复杂度低、只有两个参数且 schema 覆盖完整,但缺少输出说明、分页细节、适用场景和兄弟工具区分。对 agent 来说,这能满足最低调用需求,但在没有 annotations 的情况下仍不够完整。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
输入 schema 对 userId 和 page 都有说明,覆盖率为 100%,schema 已经承担了主要参数语义。描述本身没有在 schema 之外补充参数格式、取值范围或 userId 的获取方式,因此按高覆盖率基线给 3 分。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
描述明确指出了操作对象“微博用户作品”和动作“列表查询”,agent 能理解这是按用户获取作品列表的工具。虽然未显式与同平台的其他微博工具对比,但“用户作品列表”已经足够将其与 weibo-comment-search、weibo-hot-search 等区分开。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
描述没有说明何时使用该工具、何时应使用替代工具,也没有排除性条件。只能从“用户作品列表”暗示其用途,缺少与 weibo-search、weibo-comment-search 等兄弟工具的明确使用边界。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weibo-realtime-searchB
微博实时搜索,按关键词实时搜索微博内容
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码 | |
| keyword | Yes | 搜索关键词 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It reveals that the search is real-time and keyword-based, but it does not disclose pagination behavior, result format, freshness limitations, or whether the operation is read-only. That is too little context for a tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and easy to scan, with no unnecessary elaboration. There is minor redundancy in repeating '实时搜索', but overall it is appropriately concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter tool with no output schema, the description plus schema is minimally sufficient for invocation. However, the lack of annotations and the absence of differentiation from similar Weibo search tools makes the definition incomplete for confident tool selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the keyword and page parameters are already documented. The description adds only the 'real-time' framing and no additional semantic detail about how the parameters behave or interact.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the operation: search Weibo content in real time by keyword. It is specific enough to understand the core action, but it does not distinguish itself from sibling tools like weibo-post-search or weibo-hot-search, as '微博内容' is broad.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended use is implied: use this tool when you need real-time keyword-based Weibo search. However, there is no explicit when-to-use versus when-not-to-use guidance, and no alternative tools are mentioned, leaving sibling differentiation to the agent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-account-analyzerB
深度拆解小红书账号,输出七维度量化评分诊断报告与可导出HTML;当用户提供小红书号进行账号诊断、rednote分析、账号健康度评估、商业价值评估、多账号对比或制定优化策略时使用
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | data | |
| status | No | status | |
| message | No | message | |
| userIds | No | userIds | |
| accounts | No | accounts | |
| query_type | No | query_type | |
| output_path | No | output_path | |
| account_count | No | account_count | |
| template_structure | No | template_structure |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are absent, so the description carries the full disclosure burden. It does reveal the output artifact (7-dimension report, exportable HTML) and implies multi-account capability via '多账号对比', which is genuinely useful. However, it stays silent on read/write nature, data source, failure behavior for invalid IDs, and what the seven dimensions actually are — all left to inference.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single compact sentence front-loads the core function (deep analysis + 7-dimension report + HTML export) before the trigger conditions. Each clause earns its place; only mild redundancy exists in the six overlapping trigger scenarios (账号诊断 ≈ 账号健康度评估), but nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations, no output schema, and a schema whose descriptions are all tautologies, the description must carry the entire burden — and it covers purpose and triggers well. But it never explains how to construct a request (the roles of data/status/message/query_type/template_structure), what the seven dimensions are, or what happens on failure, so an agent would have to guess at most invocation details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is nominally 100%, every parameter description is a tautology ('data'→'data', 'status'→'status', 'message'→'message'), so the schema adds zero meaning. The tool description hints at a few mappings (小红书号→userIds, 多账号对比→accounts/account_count, 可导出HTML→output_path) but leaves query_type, template_structure, data, status, and message completely opaque, and with 0 required parameters the agent cannot infer a correct call.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb+resource+output: '深度拆解小红书账号' (deep-analyze Xiaohongshu accounts) producing '七维度量化评分诊断报告与可导出HTML' (a 7-dimension quantitative diagnostic report with exportable HTML). This is clearly account-level diagnosis, which separates it in scope from siblings like xiaohongshu-note-analyzer and xiaohongshu-search, though no sibling is explicitly named.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The semicolon-separated second clause is an explicit trigger list: '当用户提供小红书号进行账号诊断、rednote分析、账号健康度评估、商业价值评估、多账号对比或制定优化策略时使用' — use when the user supplies a Xiaohongshu ID and asks for diagnosis, health, commercial value, multi-account comparison, or optimization strategy. This gives clear context for selection, but it never states when NOT to use it or names alternatives that handle adjacent tasks (e.g., note-level or similar-account analysis).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-ai-feedA
AI小红书信息源 — 每日自动扫描小红书 AI 相关笔记,按互动量(点赞/分享/评论)筛选最火内容,智能聚类生成精美 HTML 日报,支持封面图、数据指标和每日订阅。当用户需要 AI 小红书日报、小红书AI热点、AI小红书内容、小红书信息源、xhs ai feed 时使用。
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | keyword | |
| pageNum | No | pageNum | |
| pageSize | No | pageSize |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It discloses the daily scanning cadence, engagement-based filtering, clustering, HTML output, cover images, metrics, and subscription support. It does not mention auth, rate limits, or exact delivery format, but the core behavior is clearly stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The core behavior is front-loaded and useful, but the final trigger list repeats the same need multiple times: 'AI 小红书日报、小红书AI热点、AI小红书内容、小红书信息源、xhs ai feed'. This redundancy adds length without adding information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has no output schema and no annotations, so the description must carry the load. It gives a good high-level picture and communicates the main deliverable (HTML report), but it leaves param effects and return structure unspecified. It is adequate for simple selection but not fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is nominally 100%, but each parameter description is only the parameter name itself ('keyword', 'pageNum', 'pageSize'), so no real semantics are added. The description does not clarify how keyword is matched or what pagination defaults exist, so it earns the baseline 3 rather than higher.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific function: it scans AI-related Xiaohongshu notes daily, ranks them by engagement, clusters them, and generates an HTML report. The 'AI' and '日报' framing clearly distinguishes it from sibling search, crawler, downloader, and analyzer tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly lists when to use it: when the user needs AI Xiaohongshu daily reports, AI hotspots, AI content, or an xhs AI feed. It does not explicitly mention alternatives or when-not-to-use conditions, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-coverA
小红书爆款封面设计参考,按关键词查询同赛道近30天爆款笔记,获取封面视觉规律
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 赛道关键词 | |
| startDate | No | 起始日期 YYYY-MM-DD(最近30天内) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It conveys the core read-oriented behavior: querying by keyword, a 30-day window, same category, and extracting cover patterns. However, it does not clarify what '封面视觉规律' returns (images, text summaries, statistics) or any limitations or rate limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single dense sentence with no redundancy. The core purpose is front-loaded, and every phrase contributes meaning.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description defines the query scope but leaves ambiguity about the output format and what exactly '封面视觉规律' means. With no output schema to fill that gap, an agent may not know what kind of result to expect.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents both parameters. The description reinforces the keyword and time-window semantics and adds the viral ('爆款') context, but it does not materially extend the schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific purpose: querying viral notes in the same category over the last 30 days by keyword and obtaining cover visual patterns for design reference. It clearly distinguishes itself from sibling tools by focusing on '封面' (cover) rather than titles, accounts, or video operations.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for cover design reference when a user needs visual patterns from recent viral notes, but it does not explicitly state when to use this tool versus alternatives like xiaohongshu-title or xiaohongshu-search, and it offers no exclusion conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-crawlerA
小红书作品爬取工具。根据关键词爬取小红书热门作品数据,支持按日期范围、排序方式筛选,结果以结构化表格展示。当用户需要爬取小红书作品、查询小红书热门内容、搜索小红书爆款笔记时使用。触发词:小红书爬取、小红书作品、小红书爆款、小红书搜索、小红书热门、小红书笔记查询。
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | endDate | |
| keyword | Yes | keyword | |
| sortType | No | sortType | |
| startDate | No | startDate |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden. It discloses the action (crawl by keyword), available filters, and output form (structured table), which is useful. It does not mention rate limits, live-vs-cached data, failure/anti-crawling risks, or pagination/result limits, leaving the safety and operational profile incomplete.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact: purpose, filters, output, and usage triggers are covered in a few sentences with the core action front-loaded. The trigger-word list is somewhat redundant but useful for intent matching.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 4-parameter tool with no annotations and no output schema, the description provides the basic selection and invocation context. But it lacks sortType value details, date formats, output fields, and sibling differentiation (especially xiaohongshu-search/xiaohongshu-dailytop), so it is adequate but not complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is technically 100%, each schema description is just the parameter name. The tool description adds the relation between keyword/date range/sort and the parameters, but it does not specify date format or valid sortType values, so meaningful parameter semantics remain incomplete.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the operation ('爬取小红书热门作品数据') and the resource (Xiaohongshu works), plus filter capabilities and table output. It does not explicitly distinguish this from overlapping siblings such as xiaohongshu-search or xiaohongshu-dailytop, so it misses the top level of clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives explicit user-intent scenarios ('当用户需要爬取小红书作品、查询小红书热门内容、搜索小红书爆款笔记时使用') and trigger keywords, so an agent knows when to invoke it. However it gives no when-not-to-use guidance or alternative sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-dailytopA
小红书每日爆款笔记 TOP50,查询指定日期的日榜(每日19:00更新昨日数据)
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | 分类(默认:综合全部) | 综合全部 |
| rankDate | Yes | 榜单日期 YYYY-MM-DD(最近30天) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
没有注释,描述承担行为披露责任。它揭示了关键行为:数据每日19:00更新,因此存在延迟;TOP50说明结果规模。但未说明返回结构的具体形态或可能的失败条件,对于简单查询工具尚可接受。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
单句话承载了完整功能说明和关键时效应信息,没有任何冗余。核心信息(TOP50、按日期、更新规则)全部前置,结构高效。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
工具复杂度低(2个简单参数,无嵌套对象),描述结合schema已经涵盖功能范围、时间窗口、更新延迟和结果规模。虽然没有输出schema详细说明返回字段,但'TOP50榜单'对调用决策已经足够。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
输入schema覆盖100%,rankDate和category都有描述。描述本身没有添加超出schema的参数细节,仅重复了'指定日期',所以采用基线3分。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
描述明确说明这是查询小红书每日爆款笔记TOP50日榜的工具,使用具体动词'查询'和具体的资源'每日爆款笔记TOP50'。'日榜'与兄弟工具xiaohongshu-weeklytop形成区分,代理可以凭名称和描述判断用途。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
描述了明确的使用情境:查询指定日期的日榜,并给出数据更新规则(每日19:00更新昨日数据),帮助代理判断数据时效性。虽然没有显式提及其他兄弟工具或排除条件,但'指定日期'和'日榜'已经足够说明何时使用。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-note-analyzerA
小红书笔记优化助手数据查询,按关键词查询同赛道近30天爆款笔记用于文案评分对比
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 文案主题关键词 | |
| startDate | No | 起始日期 YYYY-MM-DD(最近30天内) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It does convey a read-only query behavior and useful constraints like the 30-day window and niche scope, but it does not disclose what the response contains—such as whether it returns note lists, scores, or comparison data—or any other behavioral details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loads the main purpose in one sentence. The opening phrase '小红书笔记优化助手数据查询' is somewhat redundant with the tool name, but the rest of the sentence earns its place by specifying query scope and intended use.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple query tool with two params, the description is mostly adequate, but there is no output schema or annotations to make up for the lack of return-value detail. It explains why to use the tool but not what shape the result takes, which leaves moderate ambiguity for an agent deciding whether this tool satisfies the task.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents both keyword and startDate clearly. The description adds context around 'same niche' and 'recent 30-day viral notes,' but it largely echoes what the schema already states rather than adding substantial new parameter meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific query action: by keyword, retrieve viral Xiaohongshu notes from the same niche in the last 30 days. It also names the intended use—copy scoring comparison—which separates it from generic search tools like xiaohongshu-search or xiaohongshu-crawler.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase '用于文案评分对比' gives clear context for when an agent should choose this tool, and '同赛道近30天爆款笔记' defines the relevant scope. However, it does not explicitly say when not to use it or name alternative tools for other note-related analysis tasks.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-prohibited-wordB
小红书违禁词检测,检查笔记文案中的违规词
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 待检测文案内容 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of explaining behavior, but it only names the action and input. It does not disclose the output format (e.g., list of offending words vs pass/fail status), limits, or any other behavioral details an agent would need to handle the result correctly.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with the key action and target front-loaded. It loses one point for slight redundancy between '违禁词检测' and '检查...违规词', but it contains no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple, with one well-documented parameter, and the description covers the input scope. However, since there is no output schema, the description should at least indicate what kind of result is returned. The missing return-value information is a clear but not severe gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already describes the only parameter `content` with 100% coverage, so the baseline is 3. The description loosely maps to this parameter by saying '笔记文案', but it adds no extra semantic detail beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action (检测/检查) on a specific resource (小红书笔记文案), making it clear this tool detects prohibited words in Xiaohongshu note copy. This also distinguishes it from sibling platform-specific checkers like douyin-prohibited-word and wechat-prohibited-word.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended scenario is implied: use it when checking Xiaohongshu note copy for banned words. However, it does not explicitly state when to prefer this tool over alternatives such as multi-wordcheck or the other platform-specific prohibited-word tools, nor any exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-rewriteA
小红书文案改写能力;当用户需要将文案改写为小红书风格时使用
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It only states that it rewrites copy into Xiaohongshu style, but does not disclose what the output looks like, whether the input text is preserved in meaning, any length or style constraints, or whether the operation has side effects. This is minimal behavioral information for an agent deciding how to invoke the tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, compact sentence with both the core purpose and the trigger condition. There is no redundancy or unnecessary detail, and the key information is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool is simple with no parameters and no output schema, the description covers purpose and usage condition adequately. However, it lacks any description of the expected input source or the return value, and with no annotations to fill the gap, a slight increase in completeness would help the agent invoke it confidently.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has zero parameters, so the baseline is 4. The description adds implicit meaning by indicating that the content to rewrite is the user's provided '文案', but it does not explain how that content is supplied given the empty schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('rewrite' / '改写') and the target style ('Xiaohongshu style' / '小红书风格'), making the tool's core purpose unambiguous. It distinguishes itself from sibling 'write' tools by being about rewriting rather than creating from scratch, though it does not explicitly name any sibling alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives a clear usage condition: 'when the user needs to rewrite copy into Xiaohongshu style'. This provides sufficient context for when to select the tool, but it does not explicitly state when not to use it or mention alternatives such as xiaohongshu-write or wechat-rewrite.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-searchB
小红书笔记搜索,根据关键词获取爆款笔记数据
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| keyword | Yes | 搜索关键词,空字符串查询全站热门 | |
| pageNum | No | 页码 | |
| pageSize | No | 每页数量(最大50) | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of disclosing behavior. It only says the tool fetches viral note data by keyword, but does not explain what '爆款' means, how results are sorted, whether date range and pagination affect results, or what the response structure looks like. This is a significant transparency gap for an unannotated tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient Chinese sentence that front-loads the core purpose: search and viral note data. No wasted words. However, it is so brief that it omits useful behavioral and usage context, so it is concise rather than fully helpful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With five parameters, no annotations, and no output schema, the description is too thin to give an agent a complete picture. It does not explain return value format, sorting/filtering behavior, how the empty-keyword 'site-wide trending' option works, or any rate or access considerations. An agent could call it, but would be guessing about important runtime behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all five parameters. The description adds only the general notion of keyword-based viral note retrieval, which maps to the keyword parameter but does not add meaningful semantics beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action—searching Xiaohongshu notes by keyword and fetching popular/viral note data. This clearly identifies the tool's resource and purpose, and the '爆款笔记数据' qualifier distinguishes it from generic crawlers. However, it does not explicitly differentiate itself from siblings like xiaohongshu-dailytop or xiaohongshu-ai-feed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase '根据关键词获取爆款笔记数据' implies this tool is for keyword-driven note search, giving some usage context. But there is no explicit guidance on when to prefer it over similar Xiaohongshu search or ranking tools, nor any exclusions or alternatives mentioned. The usage is implied rather than clearly routed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-similar-accountA
小红书创作者对标账号匹配工具,输入小红书账号ID或赛道+粉丝数+账号等级,推荐可直接复制的同阶对标和可参考的高阶标杆;当用户需要小红书账号推荐、KOL对标、起号参考、账号投放选择时使用。⚠️ 严禁任何联网搜索。
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | level | |
| redId | No | redId | |
| track | No | track | |
| maxFans | No | maxFans | |
| minFans | No | minFans | |
| gmt_create | No | gmt_create | |
| high_level_accounts | No | high_level_accounts | |
| same_level_accounts | No | same_level_accounts |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden, and it delivers a meaningful disclosure: ⚠️ 严禁任何联网搜索, which tells the agent the tool operates on local/static data and no live web fetch should be attempted. It also discloses the two input modes and the copyable-vs-reference nature of outputs. It omits error behavior and rate limits, but the most operationally relevant trait is disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description packs function, inputs, outputs, use-case list, and an important constraint into a dense two-clause sentence with zero filler. The core function is front-loaded and the ⚠️ warning is appended for salience. It is slightly run-on and could be split into separate sentences, but every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
This is an 8-parameter, 0-required, no-annotation, no-output-schema tool, so the prose must carry heavy load. It covers purpose, both input modes, output types, use cases, and the offline constraint. Gaps remain: gmt_create is undefined, the return value structure is unspecified with no output schema to fill the gap, and the minFans/maxFans relationship is unclear. Adequate for routing, incomplete for confident parameter construction.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is nominally 100%, but every parameter description is a tautology ('level' → 'level', 'redId' → 'redId'), so the schema adds no real meaning. The prose compensates by mapping 账号ID→redId, 赛道→track, 粉丝数→minFans/maxFans, and 账号等级→level, and the two count parameters map to the described output types. However, gmt_create is entirely unexplained, and whether minFans/maxFans form a required range is left ambiguous.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource — 匹配 (matching) Xiaohongshu creator benchmark accounts — and specifies both input modes (account ID or track + fan count + level) and outputs (same-tier copyable benchmarks and high-tier references). This clearly differentiates it from siblings like xiaohongshu-account-analyzer, xiaohongshu-top-account, and xiaohongshu-search, which serve different functions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides four explicit when-to-use scenarios — 小红书账号推荐, KOL对标, 起号参考, 账号投放选择 — giving an agent concrete conditions for selecting this tool. It does not name alternatives or state when not to use it, but the use-case list is specific enough to route correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-titleB
小红书爆款标题生成参考,按关键词查询同赛道近30天爆款笔记标题规律
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 赛道关键词 | |
| startDate | No | 起始日期 YYYY-MM-DD(最近30天内) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must disclose behavioral details, but it only says the tool queries title patterns. It does not state whether this is a read-only lookup, what the returned data looks like, or any limits. The tool's actual behavior beyond the query is largely undisclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that packs the core purpose, resource, timeframe, and parameter intent without filler. It is front-loaded and easy to parse, though the phrase '生成参考' is slightly imprecise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
This is a simple two-parameter lookup tool with no output schema, so the description is mostly sufficient for invocation. However, it does not explain the return format, the exact output of '标题规律', or any edge cases around date range validation, leaving moderate gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the two parameters are already documented. The description adds a little context by linking keyword to '同赛道' and startDate to '近30天', but it does not meaningfully extend beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action ('查询') and resource ('同赛道近30天爆款笔记标题规律'), anchored to a keyword. It identifies what the tool returns—viral title patterns—and is distinguishable from siblings like xiaohongshu-title-score, though it does not explicitly differentiate itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description clearly implies when to use it: when you need Xiaohongshu viral title patterns by keyword within the last 30 days. It provides clear context but does not explicitly state when not to use it or name alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-title-scoreB
小红书标题评分参考,按关键词查询同赛道近30天爆款标题数据用于评分
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 赛道关键词 | |
| startDate | No | 起始日期 YYYY-MM-DD(最近30天内) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations available, the description carries the full burden of behavioral disclosure. It clearly indicates a read-only query operation and scopes it to the last 30 days and same track, and the phrase '数据用于评分' clarifies that the tool returns reference data rather than a score itself. However, it does not disclose the output format or limitations, which is a meaningful gap for a tool with no output schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The entire description is a single, information-dense sentence with no wasted words. The core purpose ('评分参考') is front-loaded, followed by the query scope and parameters. While compact, a slightly more structured breakdown (purpose, scope, output) could improve scannability, but the current form is appropriately concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter tool, the description adequately covers the query intent and parameter role, but with no output schema it leaves the return value ambiguous: it says 'data for scoring' but does not specify whether the output is a list of titles, metrics, or an actual score. This ambiguity is notable given the tool name is 'title-score', so the description is adequate but incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the description does not add parameter details beyond what the schema already provides. It reinforces the 'same track' and '30 days' constraints, but these are already stated in the parameter descriptions, so the description adds no semantic value beyond them.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('查询' - query) and a clear resource ('同赛道近30天爆款标题数据' - same-track viral title data from the last 30 days), and frames the tool as a scoring reference ('小红书标题评分参考'). It is distinguishable from generation tools like xiaohongshu-write and search tools like xiaohongshu-search by emphasizing the scoring purpose, though it does not explicitly name a competing sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool should be used when scoring a Xiaohongshu title and reference viral titles from the same track are needed ('用于评分'). However, it gives no explicit 'when vs when not' guidance and does not name alternatives, so an agent must infer the appropriate context from the tool name and the 'scoring reference' phrase.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-top-accountC
小红书头部账号榜,查询最具影响力的小红书账号
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 榜单类型 | |
| dateType | No | 日期类型:1=日榜, 2=周榜 | 1 |
| rankDate | Yes | 榜单日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of behavioral disclosure. It only says the tool queries an account ranking; it does not explain how influence is measured, what data is returned, whether results are limited, or any other behavior. It is not misleading, but it is too thin for a tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no filler or redundant wording. It is concise and readable, though it sacrifices useful context by staying so short.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
This is a simple tool with 3 flat parameters and no output schema, but the description still omits important context: valid values for 'type', what the ranking output looks like, and how this tool relates to sibling ranking tools. It is not complete enough for an agent to call it with confidence.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description itself adds no parameter-level meaning, and the schema's description for 'type' is vague ('榜单类型') without enumerating valid values. Since the schema mostly carries the load, 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb (查询) and resource (小红书头部账号榜) and clarifies that it targets the most influential Xiaohongshu accounts, so an agent can tell it is an account-ranking tool. However, it does not explicitly differentiate it from sibling tools like xiaohongshu-dailytop or xiaohongshu-weeklytop beyond the word '账号'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no guidance on when to use this tool instead of alternatives such as xiaohongshu-account-analyzer, xiaohongshu-dailytop, or xiaohongshu-weeklytop. No exclusions, prerequisites, or selection criteria are provided, leaving the agent to infer use solely from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-video-downloaderB
根据笔记链接下载小红书视频
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 小红书笔记链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden for behavioral disclosure. It only states the download action and leaves important behavior undisclosed, such as whether it returns a direct video URL, saves a file, or fails on non-video notes. This is a significant gap for an operation that could have side effects or output ambiguities.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no filler or repetition. It efficiently communicates the core purpose, and every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations and no output schema, the description must explain what happens when the tool runs, but it does not mention the return format, possible failure modes, or any limitations such as requiring a specific note type. A simple downloader still needs enough context for an agent to use the result correctly, which is missing here.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the schema already describes the only parameter as '小红书笔记链接'. The description repeats that notion without adding format constraints, validation rules, or examples, so it adds no meaningful parameter semantics beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific verb ('下载') and resource ('小红书视频'), and specifies the input as a note link. It is distinct from siblings like xiaohongshu-note-analyzer and xiaohongshu-crawler by naming the download action, though it does not explicitly contrast itself with those alternatives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use this tool: when you have a Xiaohongshu note link and want to download its video. However, it provides no explicit guidance about when not to use it or which alternative to choose among the many sibling downloaders and Xiaohongshu tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-weeklytopC
小红书七日爆款笔记,查询指定日期的七日爆款榜单
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | 分类(默认:综合全部) | 综合全部 |
| rankDate | Yes | 榜单日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only restates the query intent and does not describe output format, how the seven-day window is computed, whether the operation is read-only, or any limits or special behaviors.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence with no filler. There is slight redundancy between '七日爆款笔记' and '七日爆款榜单', but it remains efficient and easy to scan.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter tool, the description is sufficient to make a plausible call, but it leaves ambiguity about whether rankDate is the exact list date or the end of a rolling seven-day period. With no output schema, the absence of return-value information also increases the burden on the description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description loosely maps to rankDate ('指定日期') but does not add meaning beyond what the schema already documents for either parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action (查询/query) and resource (小红书七日爆款榜单), and the '七日' qualifier helps distinguish it from the similar sibling xiaohongshu-dailytop. However, it does not explicitly name the sibling it is not, so it stops short of full differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus alternatives such as xiaohongshu-dailytop or xiaohongshu-ai-feed. The intended use is only implied by the phrase '指定日期', and no exclusions or alternative routing are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
xiaohongshu-writeA
小红书笔记创作数据支撑,基于关键词查询同赛道爆款笔记供创作参考
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | 结束日期 YYYY-MM-DD | |
| keyword | Yes | 创作方向关键词 | |
| startDate | No | 起始日期 YYYY-MM-DD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses the core behavior: keyword-based lookup of same-track viral notes, implying a read-only query. However, it does not mention output format, pagination, limits, or how date filtering behaves.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that front-loads the core purpose. There is slight redundancy between '创作数据支撑' and '供创作参考', but no wasted or irrelevant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is relatively simple with one required parameter and full schema coverage, so the description is minimally sufficient. It lacks return-value detail and does not differentiate itself from similar Xiaohongshu search tools, which leaves some ambiguity for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents all three parameters. The description only reinforces the role of 'keyword' and adds no extra meaning about how startDate and endDate affect the query.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('查询') over a concrete resource ('同赛道爆款笔记') and ties it to a clear use case ('供创作参考'). It partially distinguishes itself from generic xiaohongshu-search by emphasizing viral notes in the same niche for writing support, though it does not explicitly contrast with that sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended context is clear: an agent should use this when supporting Xiaohongshu note creation by finding relevant viral notes. It does not name alternatives or exclusion conditions, but the use case is specific enough to guide invocation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
youtube-commentC
YouTube视频评论查询
| Name | Required | Description | Default |
|---|---|---|---|
| sortBy | No | 排序方式 | |
| videoId | Yes | YouTube视频ID | |
| countryCode | No | 国家代码 | |
| languageCode | No | 语言代码 | |
| continuationToken | No | 分页游标 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. '查询' implies read-only behavior, but the description does not disclose pagination via continuationToken, the effect of sortBy/countryCode/languageCode, or what the response contains. This is minimal but not contradictory.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise phrase with no wasted words and is front-loaded with the tool's purpose. It is appropriately short, though it lacks any structured elaboration about usage or behavior.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 5 parameters, no output schema, and no annotations, the description is too sparse to be fully actionable by itself. It does not explain pagination, sorting, language/country filtering, or how the returned comments are formatted, leaving significant gaps for an agent deciding how to invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds no parameter-level meaning beyond what the schema already provides, and the schema's parameter descriptions are themselves brief. The mention of 'comment query' broadly maps to videoId, but no extra semantic value is added.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('查询' / query) and resource ('YouTube视频评论' / YouTube video comments), so an agent can tell this is the YouTube comment query tool. It does not explicitly describe returning comments for a single video or differentiate from sibling comment tools beyond the platform name, so it stops short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus alternatives like bilibili-comment, twitter-comment, or youtube-digest. The only hint is the platform name in the description; no exclusions or selection criteria are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
youtube-digestB
YouTube视频字幕/文案提取(视频转文字)
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube视频链接或视频ID | |
| language | No | 字幕语言代码,如 zh/en(默认自动多语言) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only says 'video to text' with no details about output format, failure modes (e.g., missing subtitles), access requirements, or multi-language default behavior. This is insufficient for an agent to predict behavior beyond the basic function.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single concise phrase with zero filler, front-loading the core function. It is appropriately brief, though it borders on under-specification; a bit more detail would make it a 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter tool with no output schema and no annotations, the description is just above minimum viable. It identifies the tool's function but omits any mention of return shape, edge cases, or output format. Given the low complexity, this is acceptable but not fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds no extra meaning beyond the schema, but the schema already documents both parameters (url and language) with adequate descriptions. The description does not need to compensate for a coverage gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description uses a specific verb '提取' (extract) with a clear resource: YouTube video subtitles/transcript (视频字幕/文案). This clearly distinguishes it from sibling tools like youtube-video-downloader (downloads video) and youtube-comment (extracts comments). The tool's function is unambiguous and immediately understandable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance is provided. The description only states what the tool does, with no contextual conditions, excluded cases, or explicit alternatives. An agent must infer usage purely from the name and description, relying on the schema for details.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
youtube-video-downloaderA
根据视频链接下载YouTube视频
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube视频链接 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only names the operation 'download' and gives no details about the return value, whether a file path or URL is produced, whether authentication or cookies are needed, or how failures or unsupported videos are handled.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence that immediately communicates the action and resource. It contains no filler, repeated schema information, or unnecessary clauses, and the key information is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool, the core purpose and input are clear enough for basic selection and invocation. However, with no annotations and no output schema, the description leaves meaningful gaps around return behavior, prerequisites, and platform limitations, so it is only minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single 'url' parameter is already described as 'YouTube视频链接'. The description's phrase '根据视频链接' restates the parameter without adding extra meaning such as accepted URL formats, video type restrictions, or size/length constraints.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('下载'/download), a specific resource ('YouTube视频'/YouTube video), and the required input ('视频链接'/video link). This clearly separates it from platform-specific siblings like bilibili-video-downloader and from non-download YouTube tools like youtube-comment or youtube-digest.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the main usage context: use this when a user supplies a YouTube video link and wants the video downloaded. However, it does not explicitly mention alternatives or say when not to use it, such as for bilibili, Instagram, TikTok, or other platform links, so the guidance remains implicit rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
88 tool updates
v1.0.4- First observed
bilibili-comment - First observed
bilibili-keywords-accounts - First observed
bilibili-keywords-search - First observed
bilibili-portfolio-search - First observed
bilibili-search-download - First observed
bilibili-video-downloader - First observed
cn-last30days - First observed
cultural-tourism-bilibili-feed - First observed
cultural-tourism-douyin-feed - First observed
cultural-tourism-wechat-feed - First observed
cultural-tourism-xiaohongshu-feed - First observed
deepseek-websearch - First observed
doubao-websearch - First observed
douyin-account-diagnosis - First observed
douyin-ai-feed - First observed
douyin-content-surge - First observed
douyin-daily-hot - First observed
douyin-hot-trend - First observed
douyin-prohibited-word - First observed
douyin-rise-ranking - First observed
douyin-search - First observed
douyin-similar-account - First observed
douyin-subscribe - First observed
douyin-top-account - First observed
douyin-weekly-surge - First observed
gzh-astock-top - First observed
instagram-video-downloader - First observed
investor-distiller - First observed
kimi-websearch - First observed
kuaishou-account-works - First observed
kuaishou-accounts - First observed
kuaishou-comment - First observed
kuaishou-search - First observed
kuaishou-video-extract - First observed
multi-content-feed - First observed
multi-wordcheck - First observed
playlet-bili-feed - First observed
playlet-douyin-feed - First observed
playlet-wechat-feed - First observed
playlet-xiaohongshu-feed - First observed
seedance-video-gen - First observed
stock-analysis - First observed
stock-feed - First observed
tiktok-video-downloader - First observed
toutiao-search - First observed
trending-hub - First observed
trending-hub-top10 - First observed
twitter-comment - First observed
twitter-video-downloader - First observed
video-prompt-expert - First observed
visual-ops-writer - First observed
wechat-10w-hot - First observed
wechat-channels-ai-feed - First observed
wechat-channels-crawler - First observed
wechat-cover - First observed
wechat-fastest-growing - First observed
wechat-original-hot - First observed
wechat-prohibited-word - First observed
wechat-rewrite - First observed
wechat-search - First observed
wechat-similar-account - First observed
wechat-title - First observed
wechat-top-account - First observed
wechat-video-downloader - First observed
wechat-write - First observed
weibo-comment-search - First observed
weibo-hot-search - First observed
weibo-post-search - First observed
weibo-realtime-search - First observed
xiaohongshu-account-analyzer - First observed
xiaohongshu-ai-feed - First observed
xiaohongshu-cover - First observed
xiaohongshu-crawler - First observed
xiaohongshu-dailytop - First observed
xiaohongshu-note-analyzer - First observed
xiaohongshu-prohibited-word - First observed
xiaohongshu-rewrite - First observed
xiaohongshu-search - First observed
xiaohongshu-similar-account - First observed
xiaohongshu-title - First observed
xiaohongshu-title-score - First observed
xiaohongshu-top-account - First observed
xiaohongshu-video-downloader - First observed
xiaohongshu-weeklytop - First observed
xiaohongshu-write - First observed
youtube-comment - First observed
youtube-digest - First observed
youtube-video-downloader
TDQS
Scored across 88 tools
Multiple tools are functionally indistinguishable, such as deepseek-websearch, doubao-websearch, and kimi-websearch which all simply return AI search results. Within platforms, bilibili-keywords-search and bilibili-search-download overlap heavily, as do xiaohongshu-search and xiaohongshu-crawler, plus several douyin hot/trend/surge tools with unclear boundaries.
Most tools follow a loose {platform}-{function} pattern, but conventions are mixed: some are noun phrases (bilibili-comment, wechat-cover), some are verb phrases (bilibili-search-download, xiaohongshu-note-analyzer), and many deviate entirely (cn-last30days, trending-hub, video-prompt-expert, investor-distiller). Inconsistent abbreviations like bilibili vs bili and dailytop vs daily-hot further weaken predictability.
88 tools is an extreme count by any standard, far beyond the 50+ threshold for a poorly scoped server. Even accounting for multi-platform coverage, the set is bloated with redundant search, feed, hot-list, and AI-search tools that could be consolidated.
The server covers many platforms and content operations, but coverage is uneven: YouTube, TikTok, Instagram, and Twitter have only download/comment tools with no search or trend capabilities, and Douyin/Kuaishou lack dedicated video downloaders. Significant per-platform gaps would cause agent failures for common workflows like finding and downloading a Douyin video.
Maintenance
Related MCP Connectors
MCP server: AI-agent access to Chinese social & trend signals — Douyin, Weibo, Xiaohongshu/RedNote,
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
YouTube transcripts, search, channel browsing, and playlists for AI agents via MCP.
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP server for automating Xiaohongshu (RED Note). Publish posts, search content, comment, like, and analyze creator data on China's largest lifestyle social platform.18 PyPI25MIT
- AlicenseAqualityDmaintenanceMCP server enabling AI assistants to search, analyze, and generate content for Xiaohongshu (RedNote), China's leading lifestyle social media platform.69MIT
- FlicenseNot gradedqualityBmaintenanceMCP server enabling AI agents to generate AI videos and images, analyze video content, and download videos from Douyin and Xiaohongshu.-
- AlicenseAqualityAmaintenanceMCP server that provides AI agents with access to public social media data, including hot lists, searches, content details, user profiles, posts, and comments from platforms like Douyin, Xiaohongshu, Bilibili, and Weibo.651 npmMIT