Skip to main content
Glama

run_aliexpress_product_search

Search AliExpress products by keyword to compare titles, prices, and images. Filter by price, shipping, country, and sort results for sourcing or research.

Instructions

Search AliExpress products by keyword: title, price, and image. 1 point per returned record.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "keyword": "<keyword>"
    },
    "name": "run_aliexpress_product_search"
  }
}

Input Schema

NameRequiredDescriptionDefault
sortNoSort by. Options: orders = Orders, price_low_to_high = Price: low to high, price_high_to_low = Price: high to low
choiceNoAliExpress Choice
countryNoShip-to country. e.g. US
filtersNoAttribute filters. e.g. Comma-separated
keywordYesSearch term. e.g. wireless mouse
currencyNoCurrency. Options: USD = USD, EUR = EUR, GBP = GBP, CAD = CAD, AUD = AUD, RUB = RUB, BRL = BRL, CLP = CLP, JPY = JPY, KRW = KRW, CHF = CHF, SEK = SEK, PLN = PLN, ILS = ILS, NOK = NOK, DKK = DKK, NZD = NZD, MXN = MXN, COP = COP, TRY = TRY, THB = THB, SGD = SGD, MYR = MYR, PHP = PHP, IDR = IDR, INR = INR, VND = VND, HKD = HKD, TWD = TWD, AED = AED, SAR = SAR, CZK = CZK, HUF = HUF, RON = RON, BGN = BGN, UAH = UAH, KZT = KZT, ARS = ARS, EGP = EGP, ZAR = ZAR, CNY = CNY, PEN = PEN
languageNoContent language. Options: ar_MA = ar_MA, de_DE = de_DE, en_US = en_US, es_ES = es_ES, fr_FR = fr_FR, in_ID = in_ID, it_IT = it_IT, iw_IL = iw_IL, ja_JP = ja_JP, ko_KR = ko_KR, nl_NL = nl_NL, pl_PL = pl_PL, pt_BR = pt_BR, ru_RU = ru_RU, th_TH = th_TH, tr_TR = tr_TR, vi_VN = vi_VN
max_itemsNoMax items (up to 250)
max_priceNoMax price
min_priceNoMin price
ship_fromNoShip-from country. e.g. Any
start_pageNoStarting page
free_shippingNoFree shipping
local_shippingNoLocal shipping
four_star_and_upNo4 stars & up

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv1.0.1

TDQS

B3.3/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral burden. It usefully discloses a cost of 1 point per returned record and the basic returned fields, but it does not explain pagination behavior, rate limits, or how max_items and start_page interact with billing.

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

Conciseness5/5

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

The description is two compact sentences with the core purpose and cost front-loaded. There is no filler or repetition.

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?

The described purpose and cost are clear, and the schema fully documents parameters. However, for a 15-parameter search tool with no annotations and no output schema, the description omits pagination behavior, result limits, and selection guidance among sibling search tools.

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?

Schema description coverage is 100%, so all 15 parameters are already documented in the input schema. The description adds no parameter-specific semantics beyond naming keyword and returned fields, making the baseline 3 appropriate.

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?

States a specific verb and resource: search AliExpress products by keyword. It also says the output includes title, price, and image. It does not explicitly distinguish itself from nearby sibling tools like run_aliexpress_product or run_aliexpress_product_reviews.

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

Usage Guidelines2/5

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

The description implies this is a keyword-based search tool but gives no guidance on when to choose it over alternatives, such as run_alibaba_product_search or the AliExpress detail and review tools. It also does not mention pagination, sorting, or filtering strategy.

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

Deploy Server

Other Tools