Xiaohongshu Product Search (by Keyword)
omnial/xiaohongshu-app-search-products
Given a search keyword, returns matching products from Xiaohongshu's in-app shopping search: title, current and original price, product image dimensions (URLs withheld), stock status, the selling store's name and account type, and promotional badges (sales counts, flash-sale discounts) for each result, plus a page number and search id for fetching the next page.
activeper callv2
Price
Up to $0.0205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Data from Xiaohongshu.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/xiaohongshu-app-search-products" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/xiaohongshu-app-search-products" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/xiaohongshu-app-search-products", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/xiaohongshu-app-search-products", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0205 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
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
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": "Typically 'normal'."
},
"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. '$'. Not always present."
},
"rds_price": {
"type": "number",
"description": "A second price figure alongside `foreign_price`; not always present, and its meaning is not documented 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": "Typically `1` (in stock)."
},
"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. Present only on a card that is a related-search recommendation rather than a product -- 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; a card can instead be a related-search-keyword recommendation (seen for a nonsense keyword), 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.",
"additionalProperties": true
}