Taobao product search, affiliate link conversion, taocode generation. Direct official Alimama API.
Server has 5 tools with complete input schemas and descriptions, but quality is inconsistent. Tool names follow verb_noun convention (find_goods, get_item_info, create_tpwd). Descriptions are present but vary in clarity, some include scope/API IDs (27939, 16189) that are implementation details, not user-facing context. Parameters have types and defaults, but lack detailed constraints (e.g., 'count' has no min/max bounds despite API limits). Output is unstructured text (formatted strings) rather than structured JSON, forcing LLMs to parse prose. Error handling returns plain strings without recovery guidance. No tool annotations (readOnlyHint, idempotentHint). Missing output schema documentation.
Generate Tao Password (taocode) from affiliate link. Scope: 11655 Note: url must be an official affiliate link (s.click.taobao.com etc).
Get featured/curated products (rankings, deals, coupons). Scope: 16518 Common IDs: 28026 (top picks), 27446 (live coupons), 28890 (personalized)
Search Taobao products with affiliate links. Scope: 27939 (upgrade search API)
Query product details. Batch supported, comma-separated, max 40. Scope: 16189 Note: use new-format item IDs from search results.
Get recommended products (curated lists, rankings, similar items). Scope: 27939
All tools return unstructured text (formatted strings) instead of structured JSON objects. LLMs must parse prose to extract data, increasing errors and token waste. E.g., find_goods returns 'Found 123, showing 5:\n\n【Title】\n ID: 123...' instead of {items: [{id, title, price, shop, url}], total: 123}.
Parameter 'count' lacks min/max bounds in schema and description. API supports max 100, but schema has no constraint. LLMs may pass invalid values (0, 1000, negative). Description should state: 'max results, 1 - 100, default 20'.
Descriptions include implementation details (Scope: 27939, Scope: 16189, API method names) that confuse LLMs about when to use each tool. Scope IDs are Taobao internal, users don't know them. Descriptions should focus on user intent: 'Search Taobao products by keyword' not 'Scope: 27939 (upgrade search API)'.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
No output schema documented. Tools return formatted strings; LLMs cannot predict structure. Missing: field names, types, required vs optional, pagination info. E.g., does find_goods return total_count? Is it always present?
Error responses are plain strings without recovery guidance. E.g., 'Search failed: {error}' or 'TAOBAO_APP_KEY and TAOBAO_APP_SECRET required' don't tell LLM what to do next. Should be: 'Missing TAOBAO_APP_KEY. Configure via environment variable before retrying.'