Contract
input_schema.json
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"examples": [
1
],
"description": "Page number, start from 1"
},
"source": {
"type": "string",
"default": "explore_feed",
"examples": [
"explore_feed"
],
"description": "Source"
},
"keyword": {
"type": "string",
"examples": [
"手机壳"
],
"description": "Search keyword"
},
"search_id": {
"type": "string",
"description": "Search ID for pagination"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"module": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"content": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The product's own id."
},
"link": {
"type": "null",
"description": "Withheld -- a deep link to this product exists but is not returned by this tool."
},
"image": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "null",
"description": "Withheld -- the image exists (the field is present) but its URL is not returned by this tool."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"aspect_ratio": {
"type": "number"
}
},
"additionalProperties": true
}
},
"title": {
"type": "string"
},
"vendor": {
"type": "object",
"properties": {
"seller_id": {
"type": "string",
"description": "The store's own account id on Xiaohongshu."
},
"vendor_link": {
"type": "null",
"description": "Withheld -- a deep link to the store's page exists but is not returned by this tool."
},
"vendor_name": {
"type": "string",
"description": "The selling store's public display name."
},
"vendor_type": {
"type": "string",
"description": "The store's account tier, e.g. 'INDIVIDUAL_NEW', 'FLAGSHIP_SHOP', 'GENERAL_BUSINESS_SHOP', 'INDIVIDUAL_BUSINESS'."
}
},
"additionalProperties": true
},
"goods_type": {
"type": "string",
"description": "Observed as 'normal' on both fixtures calibrated."
},
"price_info": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "Current selling price, in the store's own currency."
},
"symbol": {
"type": "string",
"description": "Currency symbol, e.g. '$'. Observed on only one of the two fixtures calibrated -- not confirmed to always be present."
},
"rds_price": {
"type": "number",
"description": "A second price figure alongside `foreign_price`; observed on only one of the two fixtures calibrated, meaning is unconfirmed beyond its numeric closeness to the `foreign_price` conversion."
},
"origin_price": {
"type": "number",
"description": "Pre-discount list price, same currency as `price`."
},
"foreign_price": {
"type": "string",
"description": "An approximate USD-converted price string, e.g. '≈$13.57'."
}
},
"additionalProperties": true
},
"stock_status": {
"type": "number",
"description": "Observed as `1` (in stock) on both fixtures calibrated."
},
"scene_keywords": {
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "null",
"description": "Withheld, same as `content.link`."
},
"scene_keyword": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Related search keyword suggestions. Observed only on the card that was a related-search recommendation rather than a product, on one of the two fixtures calibrated -- not present on ordinary product cards."
},
"tag_strategy_map": {
"type": "object",
"properties": {
"behavior": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"after_price": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"before_price": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"after_shop_name": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
}
},
"description": "Short promotional/social-proof badge strings shown under a listing, grouped by where they'd render (before the price, after the price, after the shop name, or as a 'behavior' badge). Each entry's `tag_content.content` is the badge's own text, e.g. '11k+ sold', '24 sold', 'Flash sale ¥45 off', '200+ added to cart', 'No 1 in store repurchase', 'Sale price'.",
"additionalProperties": true
},
"has_buyer_explain": {
"type": "boolean",
"description": "Whether the listing has a buyer Q&A/explanation section."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The result cards for this page. Most cards are products; on the nonsense-keyword fixture, one card in the list was a related-search-keyword recommendation instead of a product, which is why `content.scene_keywords` exists as a sibling of the product fields below rather than every card having every field populated."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"page": {
"type": "number",
"description": "The page number this response covers."
},
"success": {
"type": "boolean"
},
"next_page": {
"type": "number",
"description": "The page number to request for more results."
},
"search_id": {
"type": "string",
"description": "Pass this back as `search_id` on the next call to page through results."
}
},
"description": "The product search result, as returned at routing.responseResultPath ($.output). Confirmed non-empty on both real fixtures calibrated.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 8, 2026