company_1688
1688商家/公司详情
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _token | No | 备用鉴权:fw_ 开头的 token(推荐改用 HTTP Header X-FW-Token,二选一) | |
| seller_id | Yes | 商家ID |
1688商家/公司详情
| Name | Required | Description | Default |
|---|---|---|---|
| _token | No | 备用鉴权:fw_ 开头的 token(推荐改用 HTTP Header X-FW-Token,二选一) | |
| seller_id | Yes | 商家ID |
Changes observed during successful MCP inspections.
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, and it discloses almost nothing: not whether the call is read-only, what authentication is required (the that _token exists is only in the schema), whether there are rate limits, or what the response contains. For a bare detail-fetch tool this is a real 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?
It is a single front-loaded phrase with zero filler, which is structurally clean, but it is under-specified rather than genuinely concise — there is simply nothing else in 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?
With no annotations, no output schema and no title, the description would need to convey at least the basic read semantics and return shape; it instead provides only a resource label. The fully documented schema partially compensates for the parameter gap, but the description itself is thin for the tool's role.
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 seller_id ('商家ID') and _token ('备用鉴权...') fully documented, so the baseline of 3 applies. The description adds no extra meaning about the parameters 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 phrase '1688商家/公司详情' names a specific resource (a 1688 merchant/company) and implies a detail lookup, which distinguishes it from search_1688, item_1688 and reviews_1688 siblings. However, it never explicitly frames the verb or states that it resolves a single seller by ID, so it stops short of full sibling 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 on when to use this tool versus its siblings (item_1688, search_1688, ecommerce_shop), nor any stated precondition such as needing a seller ID obtained elsewhere. The agent must infer usage entirely.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.