SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-jiimore-product-discovery

linkfox-jiimore-product-discovery

Marketing & growth

View repository

Updated 10-15 18:16

About this skill

Jiimore Product Discovery

This skill guides you on how to discover and mine high-potential Amazon products using the Jiimore product discovery engine, helping Amazon sellers find potential bestsellers through keyword-based filtering with conversion, click growth, and profitability indicators.

Core Concepts

Jiimore Product Discovery is a keyword-driven Amazon product mining tool. Given a search keyword, it returns a list of products matching specified performance criteria such as conversion rate, click growth rate, gross profit margin, pricing, reviews, and listing age. This makes it ideal for identifying emerging opportunities, validating product ideas, and competitive benchmarking.

Keyword is required: Every query must include a keyword. The keyword should be translated into the language of the target marketplace (e.g., Japanese for JP, German for DE).

Rate values are decimals: Conversion rates and growth rates are expressed as decimals between 0 and 1. For example, 0.1 means 10%, 0.25 means 25%. This is a common point of confusion when users specify percentages.

Marketplace support: Currently supports US (United States), JP (Japan), and DE (Germany). Default is US. Use US when the user doesn't specify a marketplace.

Parameter Guide

Required

Parameter Description Example
keyword Search keyword (must be translated to the target marketplace language) wireless charger

Filtering Parameters

Parameter Description Value Format
priceMin / priceMax Product price range Number (e.g., 10.0, 50.0)
totalReviewsMin / totalReviewsMax Review count range Integer (e.g., 0, 500)
customerRatingMin / customerRatingMax Customer rating range Number (e.g., 4.0, 5.0)
clickConversionRateMin / clickConversionRateMax Click-to-purchase conversion rate Decimal 0-1 (0.1 = 10%)
clickConversionRateCompositeMin / clickConversionRateCompositeMax Composite conversion rate Decimal 0-1 (0.1 = 10%)
clickCountT7Min / clickCountT7Max Weekly click count range Integer
clickCountT30Min / clickCountT30Max Monthly click count range Integer
clickCountGrowthT7Min / clickCountGrowthT7Max Weekly click growth rate Decimal 0-1 (0.1 = 10%)
clickCountGrowthT30Min / clickCountGrowthT30Max Monthly click growth rate Decimal 0-1 (0.1 = 10%)
salesVolumeT360Min / salesVolumeT360Max Annual sales volume range Integer
grossProfitMarginMin / grossProfitMarginMax Gross profit margin range Number
fbaFeeMin / fbaFeeMax FBA fee range Number
launchDateMin / launchDateMax Listing date range String: yyyyMMdd000000
nicheCountMin / nicheCountMax Niche market count range Integer
sellerCountry Seller origin country code(s), comma-separated CN,US
countryCode Target marketplace (US, JP, DE) US

Sorting & Pagination

Parameter Description Default
sortField Sort by field (see options below) purchasedClicksT360
sortType Sort direction: desc or asc desc
page Page number 1
pageSize Results per page (10-100) 50

Available sort fields: totalReviews, price, launchDate, clickCountT7, clickCountT30, clickCountT90, clickConversionRate, clickConversionRateComposite, customerRating, purchasedClicksT360, clickCountGrowthT7, clickCountGrowthT30, currentPrice, fbaFee, shippingFee, gpm

How to call

  • API endpoint：POST /jiimore/productDiscovery(for full parameters/responses/error codes, see references/api.md）
  • Python script：python scripts/jiimore_product_discovery.py '<JSON 参数>' [--inline]
  • Cost constraints: This tool consumes compute; by default, the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, do not automatically try different keywords, paginate, or change the zip code in continuous probing; if further retrieval is needed, first explain to the user that it will incur additional consumption.

Output strategy (default script behavior)：

  • Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-product-discovery-<timestamp>.json（<cwd> is the working directory when the script is executed, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, and if the current directory is not writable, report an error)
  • Response body ≤ 8 KB: after writing to disk, print the complete JSON to stdout
  • Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, length of the largest list field + first 3 samples)
  • Add --inline to force full printing to stdout (also written to disk)

Data reading suggestions: first look at the summary to determine whether it is sufficient; when specific fields are needed, prefer to use jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide resolution:

Abnormal situations

  • API Key not configured: the environment variable is not configured LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
  • Response 401 or 402 status code
  • Response indicates insufficient compute or balance: the message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Usage Examples

1. Find high-conversion wireless chargers in the US market

{
  "keyword": "wireless charger",
  "countryCode": "US",
  "clickConversionRateMin": 0.1,
  "sortField": "clickConversionRate",
  "sortType": "desc"
}

2. Discover fast-growing new products (listed within the last 6 months, weekly click growth > 20%)

{
  "keyword": "desk lamp",
  "countryCode": "US",
  "launchDateMin": "20250901000000",
  "clickCountGrowthT7Min": 0.2,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}

3. Find underpriced high-margin products with low competition (few reviews)

{
  "keyword": "phone stand",
  "countryCode": "US",
  "priceMin": 10,
  "priceMax": 30,
  "totalReviewsMax": 100,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}

4. Mine products from Chinese sellers with strong monthly click growth in the German market

{
  "keyword": "Handyhuelle",
  "countryCode": "DE",
  "sellerCountry": "CN",
  "clickCountGrowthT30Min": 0.15,
  "sortField": "clickCountGrowthT30",
  "sortType": "desc"
}

5. Find high-rated products with strong annual sales in the Japanese market

{
  "keyword": "ワイヤレスイヤホン",
  "countryCode": "JP",
  "customerRatingMin": 4.0,
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

6. Identify niche opportunities with high composite conversion and multiple niche markets

{
  "keyword": "yoga mat",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "nicheCountMin": 3,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}

Display Rules

  1. Present data clearly: Show query results in well-structured tables, including product title, ASIN, price, ratings, conversion rates, click counts, and growth rates
  2. Rate formatting: Always display rate values as percentages for readability (e.g., show 0.12 as 12%). Remind users that the API accepts decimals (0-1)
  3. Image display: When product image URLs are available, display the main product image alongside the data
  4. Pagination awareness: When results span multiple pages, inform the user of the total count and current page, and offer to fetch additional pages
  5. Keyword translation reminder: Remind users that keywords must be in the target marketplace language (English for US, Japanese for JP, German for DE)
  6. Error handling: When a query fails, explain the reason based on the response and suggest adjusting query criteria
  7. No subjective advice: Present factual product data without making subjective business recommendations

Important Limitations

  • Keyword is mandatory: Every query requires a keyword; browsing without a keyword is not supported
  • Three marketplaces only: Currently limited to US, JP, and DE
  • Page size cap: Maximum 100 results per page
  • Rate values: All rate/percentage parameters must be passed as decimals (0-1), not percentages
  • Launch date format: Must follow the yyyyMMdd000000 format exactly (e.g., 20250101000000)

User Expression & Scenario Quick Reference

Applicable -- Product discovery and mining tasks:

User Says Scenario
"Find hot products for keyword X" Keyword-based product discovery
"High conversion products", "best sellers" High-conversion product screening
"Fast growing products", "trending items" Click growth-based discovery
"New products with high potential" New listing + growth filtering
"Products with good margins", "profitable items" Gross profit margin screening
"Low competition products", "few reviews" Low-review opportunity mining
"Products from Chinese sellers" Seller origin filtering
"Niche market opportunities" Niche count-based discovery

Not applicable -- Needs beyond product discovery:

  • ABA search term data and keyword analysis (use ABA Data Explorer)
  • Advertising / PPC campaign management
  • Product reviews and listing optimization
  • Inventory management and supply chain
  • Comprehensive market reports with profit/pricing strategy

Compute consumption rules

Consumes 9 compute.

Users will pay fees due to compute consumption. Please fully assess: when this skill needs to be called frequently, or when the user's expectation of compute consumption is insufficient, be sure to remind the user and let the user decide whether to continue.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.