Skip to main content
Glama

Temu Product Source Query

nexscope_temu_product_source_query
Read-only

Filter Temu products by multiple dimensions (keyword/product ID/store ID, front/backend categories, price, rating, reviews, total/weekly/daily sales, listing date, fully-managed/semi-managed, semi-managed regions, tags, etc.). Triggered when users mention Temu products, Temu product selection, Pinduoduo cross-border, Temu bestsellers, Temu semi-managed, fully-managed products, Temu product query, or temu items. Even if the user does not mention the tool name, this skill should be triggered whenever searching for products, viewing sales/ratings/prices, or filtering products on Temu.

Input Schema

NameRequiredDescriptionDefault
pageNoPage number (starting from 1)
tagsNoProduct tags, comma-separated
regionNoSemi-managed regions, comma-separated
sortByNoSort field+direction: order_week-0 (weekly sales descending, default), price-0, order_total-0, rating-0, etc.
isLocalNoWhether semi-managed: 0=Fully managed, 1=Semi-managed
soldOutNoWhether delisted: 0=Listed, 1=Delisted
pageSizeNoResults per page, max 100, recommended not to exceed 50
priceEndNoPrice range end (USD)
ratingEndNoRating range end
searchKeyNoKeyword or product ID / store ID
customTagsNoCustom tags, comma-separated
priceBeginNoPrice range start (USD), combined to form upstream price
reviewsEndNoReview count range end
ratingBeginNoRating range start, combined to form upstream rating
categoryHomeNoFront-end category ID
reviewsBeginNoReview count range start, combined to form reviews
salesDailyEndNoDaily sales range end
salesTotalEndNoTotal sales range end
publishTimeEndNoListing date range end
salesWeeklyEndNoWeekly sales range end
categoryBackendNoBack-end category ID
salesDailyBeginNoDaily sales range start, combined to form sales_daily
salesTotalBeginNoTotal sales range start, combined to form sales_total
publishTimeBeginNoListing date range start, combined to form publish_time
salesWeeklyBeginNoWeekly sales range start, combined to form sales_weekly

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, and the description's 'Filter' framing is consistent with a safe read. Beyond that it adds no behavioral context: no pagination behavior, no indication of what the result set contains or how large it can be, no rate-limit or coverage notes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first sentence is dense and front-loaded with the useful content, but the following two sentences are keyword-stuffed trigger lists that repeat 'Temu products', 'Temu product selection', 'Temu product query', and 'temu items' without adding distinct information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 25-parameter read-only filter query with full schema coverage, the description covers the filtering surface adequately. It is still thin on what comes back (no output schema exists) and on how this tool relates to the many other Temu data endpoints in the catalog.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the baseline is 3. The description's dimension list (front/backend categories, total/weekly/daily sales, fully-managed/semi-managed, tags) loosely mirrors the schema but supplies no syntax, defaults, or range-combination rules beyond what the schema already states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

A specific verb (Filter) plus resource (Temu products) and a full enumeration of the filterable dimensions, so the agent can tell what it does. It never distinguishes itself from close siblings like nexscope_temu_store_source_query or nexscope_temu_category_search, leaving boundary selection to guesswork.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'Triggered when users mention...' sentence gives keyword-level invocation cues, which is real usage guidance. But the cues are broad catch-alls ('viewing sales/ratings/prices', 'searching for products') that do not name alternatives or exclusions, so an agent has no rule for choosing this over the Temu store or category tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.