{"id":"5efaa235-9576-41af-bd2e-3fb12ad2dc5c","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor","name":"Jiimore-细分市场评论","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor","generatedAt":"2026-10-14T16:36:48.303Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-12T00:57:47.370Z","emptyReason":null},"description":"亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。 Skill: Jiimore-细分市场评论 Owner: linkfox-ai Summary: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T05:20:00.058Z | u","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 964 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-jiimore-get-niche-review-from-keyword","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-jiimore-get-niche-review-from-keyword","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-jiimore-get-niche-review-from-keyword","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:57:47.370Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:57:47.370Z","emptyReason":null},"stars":null,"forks":null,"downloads":964,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.7","tractionLabel":"964 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:57:47.311Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T00:57:47.370Z","lastCrawledAt":"2026-10-12T00:57:47.311Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T00:57:47.311Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.7","createdAt":"2026-09-14T05:20:00.058Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":7,"zipByteSize":24861},{"version":"1.0.6","createdAt":"2026-08-14T14:54:46.819Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":7,"zipByteSize":25000},{"version":"1.0.5","createdAt":"2026-08-07T10:50:18.963Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":7,"zipByteSize":24848},{"version":"1.0.4","createdAt":"2026-07-13T12:11:14.042Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":16073},{"version":"1.0.3","createdAt":"2026-07-06T11:20:11.298Z","changelog":"Update from 1.0.2 to 1.0.3","fileCount":5,"zipByteSize":15238},{"version":"1.0.2","createdAt":"2026-07-03T08:18:58.349Z","changelog":"Update from 1.0.1 to 1.0.2","fileCount":5,"zipByteSize":15196},{"version":"1.0.1","createdAt":"2026-07-03T05:48:44.442Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":5,"zipByteSize":15165}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-jiimore-get-niche-review-from-keyword","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-14T16:36:48.302Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-jiimore-get-niche-review-from-keywor/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-12T00:57:47.370Z","emptyReason":null},"readme":"Skill: Jiimore-细分市场评论\n\nOwner: linkfox-ai\n\nSummary: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\n\nTags: latest:1.0.7\n\nVersion history:\n\nv1.0.7 | 2026-09-14T05:20:00.058Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-08-14T14:54:46.819Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-08-07T10:50:18.963Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-13T12:11:14.042Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-06T11:20:11.298Z | user\n\nUpdate from 1.0.2 to 1.0.3\n\nv1.0.2 | 2026-07-03T08:18:58.349Z | user\n\nUpdate from 1.0.1 to 1.0.2\n\nv1.0.1 | 2026-07-03T05:48:44.442Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nArchive index:\n\nArchive v1.0.7: 7 files, 24861 bytes\n\nFiles: references/api.md (9616b), references/onboarding.md (1999b), scripts/jiimore_get_niche_review.py (13222b), scripts/onboarding.py (24027b), skill-card.md (2789b), SKILL.md (13349b), _meta.json (164b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-jiimore-get-niche-review-from-keyword\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\n---\n\n# Jiimore Niche Review from Keyword\n\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\n\n## Core Concepts\n\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\n\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\n\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\n\n## Supported Marketplaces\n\nUS (United States), JP (Japan), DE (Germany)\n\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameter Guide\n\n### Required Parameter\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\n\n### Marketplace & Pagination\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| countryCode | string | US | Country code: US, JP, or DE |\n| page | integer | 1 | Page number (starting from 1) |\n| pageSize | integer | 50 | Results per page (10-100) |\n\n### Sorting\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\n\n**Sortable Fields**:\n\n| Field | Description |\n|-------|-------------|\n| unitsSoldT7 | Units sold (7-day) |\n| searchVolumeT7 | Search volume (7-day) |\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\n| clickConversionRateT7 | Click conversion rate (7-day) |\n| searchConversionRateT7 | Search conversion rate (7-day) |\n| clickCountT7 | Click count (7-day) |\n| demand | Demand score |\n| avgPrice | Average price |\n| maximumPrice | Maximum price |\n| minimumPrice | Minimum price |\n| productCount | Product count |\n| brandCount | Brand count |\n| top5BrandsClickShare | Top 5 brands click share |\n| top5ProductsClickShare | Top 5 products click share |\n| clickCountT90 | Click count (90-day) |\n| clickConversionRateT90 | Click conversion rate (90-day) |\n| searchConversionRateT90 | Search conversion rate (90-day) |\n| searchVolumeT90 | Search volume (90-day) |\n| unitsSoldT90 | Units sold (90-day) |\n| unitsSoldGrowthT90 | Units sold growth (90-day) |\n| searchVolumeGrowthT90 | Search volume growth (90-day) |\n| returnRateT360 | Return rate (360-day) |\n| newProductsLaunchedT180 | New products launched (180-day) |\n| successfulLaunchesT180 | Successful launches (180-day) |\n| launchRateT180 | Launch success rate (180-day) |\n| acos | ACOS |\n| profitRate50 | Profit rate at 50% organic orders |\n\n### Niche Filtering Parameters\n\nAll filter parameters follow a min/max range pattern. Values for percentage-based fields use a 0-1 scale (e.g., 0.05 = 5%).\n\n**Product & Brand Metrics**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| productCountMin / productCountMax | integer | Product count range |\n| brandCountMin / brandCountMax | integer | Brand count range |\n| avgPriceMin / avgPriceMax | number | Average price range |\n\n**Sales & Search Volume**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| unitsSoldT7Min / unitsSoldT7Max | integer | Units sold (7-day) range |\n| searchVolumeT7Min / searchVolumeT7Max | integer | Search volume (7-day) range |\n| clickCountT7Min / clickCountT7Max | integer | Click count (7-day) range |\n\n**Conversion & Click Rates** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| clickConversionRateT7Min / clickConversionRateT7Max | number | Click conversion rate (7-day) range |\n\n**Market Concentration** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| top5BrandsClickShareMin / top5BrandsClickShareMax | number | Top 5 brands click share range |\n| top5ProductsClickShareMin / top5ProductsClickShareMax | number | Top 5 products click share range |\n| sponsoredProductsPercentageMin / sponsoredProductsPercentageMax | number | SP ad percentage range |\n\n**Brand & Seller Age**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| avgBrandAgeMin / avgBrandAgeMax | number | Average brand age (current) |\n| avgBrandAgeQoqMin / avgBrandAgeQoqMax | number | Average brand age (90-day) |\n| avgBrandAgeYoyMin / avgBrandAgeYoyMax | number | Average brand age (360-day) |\n| avgSellingPartnerAgeMin / avgSellingPartnerAgeMax | number | Average seller age (current) |\n| avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax | number | Average seller age (90-day) |\n| avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax | number | Average seller age (360-day) |\n\n**New Product & Return Metrics** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| launchRateT180Min / launchRateT180Max | number | Launch success rate (180-day) range |\n| newProductRateT180 | number | New product percentage (180-day) min |\n| returnRateT360Min / returnRateT360Max | number | Return rate (360-day) range |\n\n**Advertising**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| cpcMediumMin / cpcMediumMax | number | CPC (current) range |\n\n## Usage Examples\n\n**1. Basic niche review lookup for a keyword**\n```\nAnalyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace.\n```\nParameters: `{\"keyword\": \"yoga mat\", \"countryCode\": \"US\"}`\n\n**2. Find niche reviews with high search volume**\n```\nShow me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"searchVolumeT7Min\": 10000}`\n\n**3. Low competition niches with review insights**\n```\nFind review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share.\n```\nParameters: `{\"keyword\": \"pet bed\", \"countryCode\": \"US\", \"top5BrandsClickShareMax\": 0.3}`\n\n**4. Japanese market niche reviews**\n```\nAnalyze niche reviews for wireless earbuds on the Japan marketplace.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"JP\"}`\n\n**5. Sorted by demand score**\n```\nShow niche reviews for \"kitchen organizer\" sorted by demand score in descending order.\n```\nParameters: `{\"keyword\": \"kitchen organizer\", \"sortField\": \"demand\", \"sortType\": \"desc\"}`\n\n**6. Filter by new product success rate**\n```\nFind niches for \"phone case\" where the 180-day new product launch success rate is above 20%.\n```\nParameters: `{\"keyword\": \"phone case\", \"launchRateT180Min\": 0.2}`\n\n**7. Low return rate niches**\n```\nShow review topics for \"water bottle\" niches with return rates below 5%.\n```\nParameters: `{\"keyword\": \"water bottle\", \"returnRateT360Max\": 0.05}`\n\n## Display Rules\n\n1. **Present data clearly**: Show review topics in a well-organized table. Include the niche name, review type (positive/negative), topic, mention percentage, and a review example\n2. **Percentage formatting**: Convert 0-1 scale values to percentages for display (e.g., 0.15 -> 15%)\n3. **Sentiment separation**: When presenting results, group or clearly label positive vs. negative reviews so users can quickly identify opportunities and pain points\n4. **Actionable insight framing**: While showing data objectively, highlight high-mention-percentage negative reviews as potential product improvement opportunities, and high-mention-percentage positive reviews as features to emphasize in listings\n5. **Volume notice**: When results are large, show the most relevant data first and remind users about pagination options\n6. **Error handling**: When a query fails, explain the reason and suggest adjusting the keyword or filter criteria\n7. **Language reminder**: If a user provides a keyword in the wrong language for the target marketplace, remind them to use the marketplace's native language (English for US, German for DE, Japanese for JP)\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Consumer review and sentiment analysis within Amazon niche markets:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"What do customers say about XX\" | Niche review topic lookup |\n| \"Customer pain points for XX\" | Negative review analysis |\n| \"What features do buyers love in XX\" | Positive review analysis |\n| \"Review sentiment for XX niche\" | Full sentiment breakdown |\n| \"Consumer demand insights for XX\" | Demand signal extraction from reviews |\n| \"Common complaints about XX products\" | Negative topic mining |\n| \"What makes XX products popular\" | Positive topic mining |\n| \"Niche market review analysis\" | General niche review exploration |\n\n**Not applicable** -- Needs beyond niche review analysis:\n- Individual ASIN review analysis (this tool works at the niche/market level)\n- Keyword search volume trends without review context (use ABA data tools instead)\n- Product listing optimization or copywriting\n- Advertising strategy and PPC management\n- Sales estimation or revenue forecasting\n\n**Boundary judgment**: When users say \"market research\" or \"product opportunity\", if their intent focuses on understanding consumer sentiment, review topics, and pain points within a niche market, this skill applies. If they are asking about search volume trends, pricing strategy, or sales data without review context, it does not apply.\n\n## 算力消耗规则\n\n消耗 9 算力。\n\n> 用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789363200058\n}\n\nFile v1.0.7:references/api.md\n\n# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\r\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\r\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\r\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\r\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\r\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\r\n\r\n**销售伙伴年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\r\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\r\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\r\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\r\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\r\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\r\n\r\n**新品与退货指标**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值 |\r\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值 |\r\n| newProductRateT180 | number | 新商品占比（180天统计）最小值 |\r\n| returnRateT360Min | number | 退货率（360天统计）最小值 |\r\n| returnRateT360Max | number | 退货率（360天统计）最大值 |\r\n\r\n**广告**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| cpcMediumMin | number | CPC（当前）最小值 |\r\n| cpcMediumMax | number | CPC（当前）最大值 |\r\n\r\n**系统字段**（可忽略，由系统自动处理）：\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总数 |\r\n| data | array | 细分市场评论列表（详见下方数据项字段） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n| title | string | 标题 |\r\n\r\n### 数据项字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheName | string | 细分市场名称 |\r\n| keyword | string | 关键词 |\r\n| reviewType | string | 评论类型（值范围为【正面评论】、【负面评论】） |\r\n| topic | string | 评论主题 |\r\n| percentOfMentions | number | 占比（数值范围为0-1，代表0%-100%） |\r\n| reviewExample | string | 评论样例 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和算力问题** 处理。|\r\n| 402 | 算力不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和算力问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n    \"errcode\": 401,\r\n    \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"yoga mat\",\r\n    \"countryCode\": \"US\",\r\n    \"pageSize\": 20,\r\n    \"sortField\": \"unitsSoldT7\",\r\n    \"sortType\": \"desc\"\r\n  }'\r\n```\r\n\r\n### 带筛选条件的示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"wireless earbuds\",\r\n    \"countryCode\": \"US\",\r\n    \"searchVolumeT7Min\": 5000,\r\n    \"top5BrandsClickShareMax\": 0.5,\r\n    \"sortField\": \"demand\",\r\n    \"sortType\": \"desc\",\r\n    \"page\": 1,\r\n    \"pageSize\": 50\r\n  }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n  \"skillName\": \"linkfox-xxx-xxx\",\r\n  \"sentiment\": \"POSITIVE\",\r\n  \"category\": \"OTHER\",\r\n  \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\r\n\r\n**Field rules:**\r\n- `skillName`: Use this skill's `name` from the YAML frontmatter\r\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\r\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\r\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.7:references/onboarding.md\n\n# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nJiimore analyzes Amazon niche-market reviews from a keyword to surface sentiment, recurring topics, customer pain points, and review examples for supported marketplaces.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal Amazon sellers and market researchers use this skill to request Jiimore niche review data for a keyword and turn returned review topics into consumer sentiment and product opportunity insights.\n\n### Deployment Geography for Use:\n\nGlobal; supported marketplace data is limited to the United States, Japan, and Germany.\n\n## Known Risks and Mitigations:\n\nRisk: The skill makes LinkFox/Jiimore network calls that can consume paid credits.\n\nMitigation: Confirm user intent before repeated calls, rely on the documented 24-hour parameter cache, and disclose additional cost before retries or expanded searches.\n\nRisk: The onboarding flow can involve phone/SMS login and payment steps.\n\nMitigation: Prefer the self-service LinkFox account page for key setup, avoid asking users to enter OTPs in chat where possible, and present payment actions for explicit user confirmation.\n\nRisk: API responses and session metadata are persisted locally.\n\nMitigation: Store results only in the documented workspace linkfox directory and remind users that saved review data and metadata may need cleanup under their local data-retention practices.\n\nRisk: Endpoint override environment variables can redirect requests to untrusted destinations.\n\nMitigation: Use the default LinkFox endpoints unless the user explicitly trusts and verifies any LINKFOX_* override destination.\n\n## Reference(s):\n\n- [Jiimore Niche Review API Reference](references/api.md)\n- [LinkFox Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub skill listing](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword)\n- [LinkFox Skills](https://skill.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON, files, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON API responses or saved JSON response files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Full API responses are saved under a local linkfox session directory; large responses are summarized unless inline output is requested.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.6: 7 files, 25000 bytes\n\nFiles: references/api.md (9616b), references/onboarding.md (2046b), scripts/jiimore_get_niche_review.py (13126b), scripts/onboarding.py (24089b), skill-card.md (3057b), SKILL.md (13349b), _meta.json (164b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-jiimore-get-niche-review-from-keyword\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\n---\n\n# Jiimore Niche Review from Keyword\n\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\n\n## Core Concepts\n\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\n\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\n\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\n\n## Supported Marketplaces\n\nUS (United States), JP (Japan), DE (Germany)\n\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameter Guide\n\n### Required Parameter\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\n\n### Marketplace & Pagination\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| countryCode | string | US | Country code: US, JP, or DE |\n| page | integer | 1 | Page number (starting from 1) |\n| pageSize | integer | 50 | Results per page (10-100) |\n\n### Sorting\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\n\n**Sortable Fields**:\n\n| Field | Description |\n|-------|-------------|\n| unitsSoldT7 | Units sold (7-day) |\n| searchVolumeT7 | Search volume (7-day) |\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\n| clickConversionRateT7 | Click conversion rate (7-day) |\n| searchConversionRateT7 | Search conversion rate (7-day) |\n| clickCountT7 | Click count (7-day) |\n| demand | Demand score |\n| avgPrice | Average price |\n| maximumPrice | Maximum price |\n| minimumPrice | Minimum price |\n| productCount | Product count |\n| brandCount | Brand count |\n| top5BrandsClickShare | Top 5 brands click share |\n| top5ProductsClickShare | Top 5 products click share |\n| clickCountT90 | Click count (90-day) |\n| clickConversionRateT90 | Click conversion rate (90-day) |\n| searchConversionRateT90 | Search conversion rate (90-day) |\n| searchVolumeT90 | Search volume (90-day) |\n| unitsSoldT90 | Units sold (90-day) |\n| unitsSoldGrowthT90 | Units sold growth (90-day) |\n| searchVolumeGrowthT90 | Search volume growth (90-day) |\n| returnRateT360 | Return rate (360-day) |\n| newProductsLaunchedT180 | New products launched (180-day) |\n| successfulLaunchesT180 | Successful launches (180-day) |\n| launchRateT180 | Launch success rate (180-day) |\n| acos | ACOS |\n| profitRate50 | Profit rate at 50% organic orders |\n\n### Niche Filtering Parameters\n\nAll filter parameters follow a min/max range pattern. Values for percentage-based fields use a 0-1 scale (e.g., 0.05 = 5%).\n\n**Product & Brand Metrics**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| productCountMin / productCountMax | integer | Product count range |\n| brandCountMin / brandCountMax | integer | Brand count range |\n| avgPriceMin / avgPriceMax | number | Average price range |\n\n**Sales & Search Volume**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| unitsSoldT7Min / unitsSoldT7Max | integer | Units sold (7-day) range |\n| searchVolumeT7Min / searchVolumeT7Max | integer | Search volume (7-day) range |\n| clickCountT7Min / clickCountT7Max | integer | Click count (7-day) range |\n\n**Conversion & Click Rates** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| clickConversionRateT7Min / clickConversionRateT7Max | number | Click conversion rate (7-day) range |\n\n**Market Concentration** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| top5BrandsClickShareMin / top5BrandsClickShareMax | number | Top 5 brands click share range |\n| top5ProductsClickShareMin / top5ProductsClickShareMax | number | Top 5 products click share range |\n| sponsoredProductsPercentageMin / sponsoredProductsPercentageMax | number | SP ad percentage range |\n\n**Brand & Seller Age**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| avgBrandAgeMin / avgBrandAgeMax | number | Average brand age (current) |\n| avgBrandAgeQoqMin / avgBrandAgeQoqMax | number | Average brand age (90-day) |\n| avgBrandAgeYoyMin / avgBrandAgeYoyMax | number | Average brand age (360-day) |\n| avgSellingPartnerAgeMin / avgSellingPartnerAgeMax | number | Average seller age (current) |\n| avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax | number | Average seller age (90-day) |\n| avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax | number | Average seller age (360-day) |\n\n**New Product & Return Metrics** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| launchRateT180Min / launchRateT180Max | number | Launch success rate (180-day) range |\n| newProductRateT180 | number | New product percentage (180-day) min |\n| returnRateT360Min / returnRateT360Max | number | Return rate (360-day) range |\n\n**Advertising**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| cpcMediumMin / cpcMediumMax | number | CPC (current) range |\n\n## Usage Examples\n\n**1. Basic niche review lookup for a keyword**\n```\nAnalyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace.\n```\nParameters: `{\"keyword\": \"yoga mat\", \"countryCode\": \"US\"}`\n\n**2. Find niche reviews with high search volume**\n```\nShow me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"searchVolumeT7Min\": 10000}`\n\n**3. Low competition niches with review insights**\n```\nFind review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share.\n```\nParameters: `{\"keyword\": \"pet bed\", \"countryCode\": \"US\", \"top5BrandsClickShareMax\": 0.3}`\n\n**4. Japanese market niche reviews**\n```\nAnalyze niche reviews for wireless earbuds on the Japan marketplace.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"JP\"}`\n\n**5. Sorted by demand score**\n```\nShow niche reviews for \"kitchen organizer\" sorted by demand score in descending order.\n```\nParameters: `{\"keyword\": \"kitchen organizer\", \"sortField\": \"demand\", \"sortType\": \"desc\"}`\n\n**6. Filter by new product success rate**\n```\nFind niches for \"phone case\" where the 180-day new product launch success rate is above 20%.\n```\nParameters: `{\"keyword\": \"phone case\", \"launchRateT180Min\": 0.2}`\n\n**7. Low return rate niches**\n```\nShow review topics for \"water bottle\" niches with return rates below 5%.\n```\nParameters: `{\"keyword\": \"water bottle\", \"returnRateT360Max\": 0.05}`\n\n## Display Rules\n\n1. **Present data clearly**: Show review topics in a well-organized table. Include the niche name, review type (positive/negative), topic, mention percentage, and a review example\n2. **Percentage formatting**: Convert 0-1 scale values to percentages for display (e.g., 0.15 -> 15%)\n3. **Sentiment separation**: When presenting results, group or clearly label positive vs. negative reviews so users can quickly identify opportunities and pain points\n4. **Actionable insight framing**: While showing data objectively, highlight high-mention-percentage negative reviews as potential product improvement opportunities, and high-mention-percentage positive reviews as features to emphasize in listings\n5. **Volume notice**: When results are large, show the most relevant data first and remind users about pagination options\n6. **Error handling**: When a query fails, explain the reason and suggest adjusting the keyword or filter criteria\n7. **Language reminder**: If a user provides a keyword in the wrong language for the target marketplace, remind them to use the marketplace's native language (English for US, German for DE, Japanese for JP)\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Consumer review and sentiment analysis within Amazon niche markets:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"What do customers say about XX\" | Niche review topic lookup |\n| \"Customer pain points for XX\" | Negative review analysis |\n| \"What features do buyers love in XX\" | Positive review analysis |\n| \"Review sentiment for XX niche\" | Full sentiment breakdown |\n| \"Consumer demand insights for XX\" | Demand signal extraction from reviews |\n| \"Common complaints about XX products\" | Negative topic mining |\n| \"What makes XX products popular\" | Positive topic mining |\n| \"Niche market review analysis\" | General niche review exploration |\n\n**Not applicable** -- Needs beyond niche review analysis:\n- Individual ASIN review analysis (this tool works at the niche/market level)\n- Keyword search volume trends without review context (use ABA data tools instead)\n- Product listing optimization or copywriting\n- Advertising strategy and PPC management\n- Sales estimation or revenue forecasting\n\n**Boundary judgment**: When users say \"market research\" or \"product opportunity\", if their intent focuses on understanding consumer sentiment, review topics, and pain points within a niche market, this skill applies. If they are asking about search volume trends, pricing strategy, or sales data without review context, it does not apply.\n\n## 积分消耗规则\n\n消耗 9 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1786719286819\n}\n\nFile v1.0.6:references/api.md\n\n# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\r\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\r\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\r\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\r\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\r\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\r\n\r\n**销售伙伴年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\r\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\r\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\r\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\r\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\r\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\r\n\r\n**新品与退货指标**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值 |\r\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值 |\r\n| newProductRateT180 | number | 新商品占比（180天统计）最小值 |\r\n| returnRateT360Min | number | 退货率（360天统计）最小值 |\r\n| returnRateT360Max | number | 退货率（360天统计）最大值 |\r\n\r\n**广告**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| cpcMediumMin | number | CPC（当前）最小值 |\r\n| cpcMediumMax | number | CPC（当前）最大值 |\r\n\r\n**系统字段**（可忽略，由系统自动处理）：\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总数 |\r\n| data | array | 细分市场评论列表（详见下方数据项字段） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n| title | string | 标题 |\r\n\r\n### 数据项字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheName | string | 细分市场名称 |\r\n| keyword | string | 关键词 |\r\n| reviewType | string | 评论类型（值范围为【正面评论】、【负面评论】） |\r\n| topic | string | 评论主题 |\r\n| percentOfMentions | number | 占比（数值范围为0-1，代表0%-100%） |\r\n| reviewExample | string | 评论样例 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n    \"errcode\": 401,\r\n    \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"yoga mat\",\r\n    \"countryCode\": \"US\",\r\n    \"pageSize\": 20,\r\n    \"sortField\": \"unitsSoldT7\",\r\n    \"sortType\": \"desc\"\r\n  }'\r\n```\r\n\r\n### 带筛选条件的示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"wireless earbuds\",\r\n    \"countryCode\": \"US\",\r\n    \"searchVolumeT7Min\": 5000,\r\n    \"top5BrandsClickShareMax\": 0.5,\r\n    \"sortField\": \"demand\",\r\n    \"sortType\": \"desc\",\r\n    \"page\": 1,\r\n    \"pageSize\": 50\r\n  }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n  \"skillName\": \"linkfox-xxx-xxx\",\r\n  \"sentiment\": \"POSITIVE\",\r\n  \"category\": \"OTHER\",\r\n  \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\r\n\r\n**Field rules:**\r\n- `skillName`: Use this skill's `name` from the YAML frontmatter\r\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\r\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\r\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.6:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nQueries Jiimore-powered Amazon niche review data from a keyword and helps agents summarize consumer sentiment, customer pain points, and positive or negative review themes.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal Amazon sellers, ecommerce operators, and market researchers use this skill to inspect niche-level review topics, sentiment, and customer pain points for Amazon marketplace keywords.\n\n### Deployment Geography for Use:\n\nGlobal; marketplace data queries are limited to the United States, Japan, and Germany.\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses a paid LinkFox integration and each niche review lookup consumes credits.\n\nMitigation: Confirm the user understands the credit cost before repeated or exploratory calls, and rely on the built-in cache for identical requests within the same 24-hour window.\n\nRisk: Authentication and onboarding flows may ask for phone/SMS login, generate API keys, and create payment orders.\n\nMitigation: Prefer self-service account setup, avoid sharing one-time codes in chat when possible, and store API keys in a secret manager instead of plain shell profiles.\n\nRisk: The lookup script writes full API responses to local session files.\n\nMitigation: Review saved JSON files before sharing them and remove local response files when they contain sensitive business or account information.\n\nRisk: Endpoint override environment variables can change where credentials and request data are sent.\n\nMitigation: Do not set LinkFox endpoint override variables unless the destination is fully trusted and intentionally configured.\n\nRisk: The skill can send feedback to a separate LinkFox feedback endpoint.\n\nMitigation: Keep feedback content minimal and avoid including secrets, personal data, or confidential marketplace research.\n\n## Reference(s):\n\n- [Jiimore Amazon Niche Review API Reference](artifact/references/api.md)\n- [Authentication and Credits Onboarding](artifact/references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown summaries and tables with saved JSON response files and inline shell commands when setup or billing actions are needed.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The lookup script caches matching requests for 24 hours, saves full responses locally, prints small responses inline, and summarizes larger responses unless full inline output is requested.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.5: 7 files, 24848 bytes\n\nFiles: references/api.md (9616b), references/onboarding.md (2046b), scripts/jiimore_get_niche_review.py (13126b), scripts/onboarding.py (24089b), skill-card.md (2786b), SKILL.md (13349b), _meta.json (164b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-jiimore-get-niche-review-from-keyword\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\n---\n\n# Jiimore Niche Review from Keyword\n\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\n\n## Core Concepts\n\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\n\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\n\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\n\n## Supported Marketplaces\n\nUS (United States), JP (Japan), DE (Germany)\n\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameter Guide\n\n### Required Parameter\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\n\n### Marketplace & Pagination\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| countryCode | string | US | Country code: US, JP, or DE |\n| page | integer | 1 | Page number (starting from 1) |\n| pageSize | integer | 50 | Results per page (10-100) |\n\n### Sorting\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\n\n**Sortable Fields**:\n\n| Field | Description |\n|-------|-------------|\n| unitsSoldT7 | Units sold (7-day) |\n| searchVolumeT7 | Search volume (7-day) |\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\n| clickConversionRateT7 | Click conversion rate (7-day) |\n| searchConversionRateT7 | Search conversion rate (7-day) |\n| clickCountT7 | Click count (7-day) |\n| demand | Demand score |\n| avgPrice | Average price |\n| maximumPrice | Maximum price |\n| minimumPrice | Minimum price |\n| productCount | Product count |\n| brandCount | Brand count |\n| top5BrandsClickShare | Top 5 brands click share |\n| top5ProductsClickShare | Top 5 products click share |\n| clickCountT90 | Click count (90-day) |\n| clickConversionRateT90 | Click conversion rate (90-day) |\n| searchConversionRateT90 | Search conversion rate (90-day) |\n| searchVolumeT90 | Search volume (90-day) |\n| unitsSoldT90 | Units sold (90-day) |\n| unitsSoldGrowthT90 | Units sold growth (90-day) |\n| searchVolumeGrowthT90 | Search volume growth (90-day) |\n| returnRateT360 | Return rate (360-day) |\n| newProductsLaunchedT180 | New products launched (180-day) |\n| successfulLaunchesT180 | Successful launches (180-day) |\n| launchRateT180 | Launch success rate (180-day) |\n| acos | ACOS |\n| profitRate50 | Profit rate at 50% organic orders |\n\n### Niche Filtering Parameters\n\nAll filter parameters follow a min/max range pattern. Values for percentage-based fields use a 0-1 scale (e.g., 0.05 = 5%).\n\n**Product & Brand Metrics**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| productCountMin / productCountMax | integer | Product count range |\n| brandCountMin / brandCountMax | integer | Brand count range |\n| avgPriceMin / avgPriceMax | number | Average price range |\n\n**Sales & Search Volume**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| unitsSoldT7Min / unitsSoldT7Max | integer | Units sold (7-day) range |\n| searchVolumeT7Min / searchVolumeT7Max | integer | Search volume (7-day) range |\n| clickCountT7Min / clickCountT7Max | integer | Click count (7-day) range |\n\n**Conversion & Click Rates** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| clickConversionRateT7Min / clickConversionRateT7Max | number | Click conversion rate (7-day) range |\n\n**Market Concentration** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| top5BrandsClickShareMin / top5BrandsClickShareMax | number | Top 5 brands click share range |\n| top5ProductsClickShareMin / top5ProductsClickShareMax | number | Top 5 products click share range |\n| sponsoredProductsPercentageMin / sponsoredProductsPercentageMax | number | SP ad percentage range |\n\n**Brand & Seller Age**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| avgBrandAgeMin / avgBrandAgeMax | number | Average brand age (current) |\n| avgBrandAgeQoqMin / avgBrandAgeQoqMax | number | Average brand age (90-day) |\n| avgBrandAgeYoyMin / avgBrandAgeYoyMax | number | Average brand age (360-day) |\n| avgSellingPartnerAgeMin / avgSellingPartnerAgeMax | number | Average seller age (current) |\n| avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax | number | Average seller age (90-day) |\n| avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax | number | Average seller age (360-day) |\n\n**New Product & Return Metrics** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| launchRateT180Min / launchRateT180Max | number | Launch success rate (180-day) range |\n| newProductRateT180 | number | New product percentage (180-day) min |\n| returnRateT360Min / returnRateT360Max | number | Return rate (360-day) range |\n\n**Advertising**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| cpcMediumMin / cpcMediumMax | number | CPC (current) range |\n\n## Usage Examples\n\n**1. Basic niche review lookup for a keyword**\n```\nAnalyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace.\n```\nParameters: `{\"keyword\": \"yoga mat\", \"countryCode\": \"US\"}`\n\n**2. Find niche reviews with high search volume**\n```\nShow me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"searchVolumeT7Min\": 10000}`\n\n**3. Low competition niches with review insights**\n```\nFind review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share.\n```\nParameters: `{\"keyword\": \"pet bed\", \"countryCode\": \"US\", \"top5BrandsClickShareMax\": 0.3}`\n\n**4. Japanese market niche reviews**\n```\nAnalyze niche reviews for wireless earbuds on the Japan marketplace.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"JP\"}`\n\n**5. Sorted by demand score**\n```\nShow niche reviews for \"kitchen organizer\" sorted by demand score in descending order.\n```\nParameters: `{\"keyword\": \"kitchen organizer\", \"sortField\": \"demand\", \"sortType\": \"desc\"}`\n\n**6. Filter by new product success rate**\n```\nFind niches for \"phone case\" where the 180-day new product launch success rate is above 20%.\n```\nParameters: `{\"keyword\": \"phone case\", \"launchRateT180Min\": 0.2}`\n\n**7. Low return rate niches**\n```\nShow review topics for \"water bottle\" niches with return rates below 5%.\n```\nParameters: `{\"keyword\": \"water bottle\", \"returnRateT360Max\": 0.05}`\n\n## Display Rules\n\n1. **Present data clearly**: Show review topics in a well-organized table. Include the niche name, review type (positive/negative), topic, mention percentage, and a review example\n2. **Percentage formatting**: Convert 0-1 scale values to percentages for display (e.g., 0.15 -> 15%)\n3. **Sentiment separation**: When presenting results, group or clearly label positive vs. negative reviews so users can quickly identify opportunities and pain points\n4. **Actionable insight framing**: While showing data objectively, highlight high-mention-percentage negative reviews as potential product improvement opportunities, and high-mention-percentage positive reviews as features to emphasize in listings\n5. **Volume notice**: When results are large, show the most relevant data first and remind users about pagination options\n6. **Error handling**: When a query fails, explain the reason and suggest adjusting the keyword or filter criteria\n7. **Language reminder**: If a user provides a keyword in the wrong language for the target marketplace, remind them to use the marketplace's native language (English for US, German for DE, Japanese for JP)\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Consumer review and sentiment analysis within Amazon niche markets:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"What do customers say about XX\" | Niche review topic lookup |\n| \"Customer pain points for XX\" | Negative review analysis |\n| \"What features do buyers love in XX\" | Positive review analysis |\n| \"Review sentiment for XX niche\" | Full sentiment breakdown |\n| \"Consumer demand insights for XX\" | Demand signal extraction from reviews |\n| \"Common complaints about XX products\" | Negative topic mining |\n| \"What makes XX products popular\" | Positive topic mining |\n| \"Niche market review analysis\" | General niche review exploration |\n\n**Not applicable** -- Needs beyond niche review analysis:\n- Individual ASIN review analysis (this tool works at the niche/market level)\n- Keyword search volume trends without review context (use ABA data tools instead)\n- Product listing optimization or copywriting\n- Advertising strategy and PPC management\n- Sales estimation or revenue forecasting\n\n**Boundary judgment**: When users say \"market research\" or \"product opportunity\", if their intent focuses on understanding consumer sentiment, review topics, and pain points within a niche market, this skill applies. If they are asking about search volume trends, pricing strategy, or sales data without review context, it does not apply.\n\n## 积分消耗规则\n\n消耗 9 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1786099818963\n}\n\nFile v1.0.5:references/api.md\n\n# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\r\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\r\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\r\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\r\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\r\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\r\n\r\n**销售伙伴年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\r\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\r\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\r\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\r\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\r\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\r\n\r\n**新品与退货指标**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值 |\r\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值 |\r\n| newProductRateT180 | number | 新商品占比（180天统计）最小值 |\r\n| returnRateT360Min | number | 退货率（360天统计）最小值 |\r\n| returnRateT360Max | number | 退货率（360天统计）最大值 |\r\n\r\n**广告**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| cpcMediumMin | number | CPC（当前）最小值 |\r\n| cpcMediumMax | number | CPC（当前）最大值 |\r\n\r\n**系统字段**（可忽略，由系统自动处理）：\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总数 |\r\n| data | array | 细分市场评论列表（详见下方数据项字段） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n| title | string | 标题 |\r\n\r\n### 数据项字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheName | string | 细分市场名称 |\r\n| keyword | string | 关键词 |\r\n| reviewType | string | 评论类型（值范围为【正面评论】、【负面评论】） |\r\n| topic | string | 评论主题 |\r\n| percentOfMentions | number | 占比（数值范围为0-1，代表0%-100%） |\r\n| reviewExample | string | 评论样例 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n    \"errcode\": 401,\r\n    \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"yoga mat\",\r\n    \"countryCode\": \"US\",\r\n    \"pageSize\": 20,\r\n    \"sortField\": \"unitsSoldT7\",\r\n    \"sortType\": \"desc\"\r\n  }'\r\n```\r\n\r\n### 带筛选条件的示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"wireless earbuds\",\r\n    \"countryCode\": \"US\",\r\n    \"searchVolumeT7Min\": 5000,\r\n    \"top5BrandsClickShareMax\": 0.5,\r\n    \"sortField\": \"demand\",\r\n    \"sortType\": \"desc\",\r\n    \"page\": 1,\r\n    \"pageSize\": 50\r\n  }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n  \"skillName\": \"linkfox-xxx-xxx\",\r\n  \"sentiment\": \"POSITIVE\",\r\n  \"category\": \"OTHER\",\r\n  \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\r\n\r\n**Field rules:**\r\n- `skillName`: Use this skill's `name` from the YAML frontmatter\r\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\r\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\r\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.5:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nJiimore helps Amazon sellers query niche-market review topics and consumer sentiment from keywords for the US, Japan, and Germany Amazon marketplaces.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal Amazon sellers and market researchers use this skill to analyze customer sentiment, pain points, and frequently mentioned review topics for keyword-defined Amazon niche markets.\n\n### Deployment Geography for Use:\n\nGlobal; data queries are limited to the US, Japan, and Germany Amazon marketplaces.\n\n## Known Risks and Mitigations:\n\nRisk: The skill handles LinkFox API credentials, phone login codes, account tokens, payment QR generation, paid plan purchase flows, automatic feedback reporting, and local response persistence.\n\nMitigation: Install only when those behaviors are acceptable, prefer LinkFox official self-service pages for login and billing, and review any credential or payment steps before use.\n\nRisk: Environment-configured base URLs and API credentials affect where account and review requests are sent.\n\nMitigation: Verify LinkFox environment variables and base URLs before running the scripts, especially in shared or managed workspaces.\n\nRisk: Saved response and cache files may contain sensitive business data from niche-market research.\n\nMitigation: Delete local linkfox output and cache files when the data is no longer needed or when working in a shared environment.\n\nRisk: API calls consume LinkFox credits and repeated use may create additional cost.\n\nMitigation: Confirm user intent before repeated calls, rely on the built-in cache for repeated parameter sets, and avoid automatic retries with changed search parameters.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword)\n- [API reference](references/api.md)\n- [Authentication and billing onboarding](references/onboarding.md)\n- [LinkFox Skills](https://skill.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance, shell commands, and JSON response files or summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Full API responses are saved locally; large responses are summarized unless inline output is requested.]\n\n## Skill Version(s):\n\n1.0.5 (source: ClawHub server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 5 files, 16073 bytes\n\nFiles: references/api.md (9616b), scripts/jiimore_get_niche_review.py (13126b), skill-card.md (3026b), SKILL.md (13966b), _meta.json (164b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-jiimore-get-niche-review-from-keyword\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\n---\n\n# Jiimore Niche Review from Keyword\n\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\n\n## Core Concepts\n\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\n\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\n\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\n\n## Supported Marketplaces\n\nUS (United States), JP (Japan), DE (Germany)\n\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。\n- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## Parameter Guide\n\n### Required Parameter\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\n\n### Marketplace & Pagination\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| countryCode | string | US | Country code: US, JP, or DE |\n| page | integer | 1 | Page number (starting from 1) |\n| pageSize | integer | 50 | Results per page (10-100) |\n\n### Sorting\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\n\n**Sortable Fields**:\n\n| Field | Description |\n|-------|-------------|\n| unitsSoldT7 | Units sold (7-day) |\n| searchVolumeT7 | Search volume (7-day) |\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\n| clickConversionRateT7 | Click conversion rate (7-day) |\n| searchConversionRateT7 | Search conversion rate (7-day) |\n| clickCountT7 | Click count (7-day) |\n| demand | Demand score |\n| avgPrice | Average price |\n| maximumPrice | Maximum price |\n| minimumPrice | Minimum price |\n| productCount | Product count |\n| brandCount | Brand count |\n| top5BrandsClickShare | Top 5 brands click share |\n| top5ProductsClickShare | Top 5 products click share |\n| clickCountT90 | Click count (90-day) |\n| clickConversionRateT90 | Click conversion rate (90-day) |\n| searchConversionRateT90 | Search conversion rate (90-day) |\n| searchVolumeT90 | Search volume (90-day) |\n| unitsSoldT90 | Units sold (90-day) |\n| unitsSoldGrowthT90 | Units sold growth (90-day) |\n| searchVolumeGrowthT90 | Search volume growth (90-day) |\n| returnRateT360 | Return rate (360-day) |\n| newProductsLaunchedT180 | New products launched (180-day) |\n| successfulLaunchesT180 | Successful launches (180-day) |\n| launchRateT180 | Launch success rate (180-day) |\n| acos | ACOS |\n| profitRate50 | Profit rate at 50% organic orders |\n\n### Niche Filtering Parameters\n\nAll filter parameters follow a min/max range pattern. Values for percentage-based fields use a 0-1 scale (e.g., 0.05 = 5%).\n\n**Product & Brand Metrics**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| productCountMin / productCountMax | integer | Product count range |\n| brandCountMin / brandCountMax | integer | Brand count range |\n| avgPriceMin / avgPriceMax | number | Average price range |\n\n**Sales & Search Volume**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| unitsSoldT7Min / unitsSoldT7Max | integer | Units sold (7-day) range |\n| searchVolumeT7Min / searchVolumeT7Max | integer | Search volume (7-day) range |\n| clickCountT7Min / clickCountT7Max | integer | Click count (7-day) range |\n\n**Conversion & Click Rates** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| clickConversionRateT7Min / clickConversionRateT7Max | number | Click conversion rate (7-day) range |\n\n**Market Concentration** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| top5BrandsClickShareMin / top5BrandsClickShareMax | number | Top 5 brands click share range |\n| top5ProductsClickShareMin / top5ProductsClickShareMax | number | Top 5 products click share range |\n| sponsoredProductsPercentageMin / sponsoredProductsPercentageMax | number | SP ad percentage range |\n\n**Brand & Seller Age**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| avgBrandAgeMin / avgBrandAgeMax | number | Average brand age (current) |\n| avgBrandAgeQoqMin / avgBrandAgeQoqMax | number | Average brand age (90-day) |\n| avgBrandAgeYoyMin / avgBrandAgeYoyMax | number | Average brand age (360-day) |\n| avgSellingPartnerAgeMin / avgSellingPartnerAgeMax | number | Average seller age (current) |\n| avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax | number | Average seller age (90-day) |\n| avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax | number | Average seller age (360-day) |\n\n**New Product & Return Metrics** (0-1 scale):\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| launchRateT180Min / launchRateT180Max | number | Launch success rate (180-day) range |\n| newProductRateT180 | number | New product percentage (180-day) min |\n| returnRateT360Min / returnRateT360Max | number | Return rate (360-day) range |\n\n**Advertising**:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| cpcMediumMin / cpcMediumMax | number | CPC (current) range |\n\n## Usage Examples\n\n**1. Basic niche review lookup for a keyword**\n```\nAnalyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace.\n```\nParameters: `{\"keyword\": \"yoga mat\", \"countryCode\": \"US\"}`\n\n**2. Find niche reviews with high search volume**\n```\nShow me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"searchVolumeT7Min\": 10000}`\n\n**3. Low competition niches with review insights**\n```\nFind review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share.\n```\nParameters: `{\"keyword\": \"pet bed\", \"countryCode\": \"US\", \"top5BrandsClickShareMax\": 0.3}`\n\n**4. Japanese market niche reviews**\n```\nAnalyze niche reviews for wireless earbuds on the Japan marketplace.\n```\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"JP\"}`\n\n**5. Sorted by demand score**\n```\nShow niche reviews for \"kitchen organizer\" sorted by demand score in descending order.\n```\nParameters: `{\"keyword\": \"kitchen organizer\", \"sortField\": \"demand\", \"sortType\": \"desc\"}`\n\n**6. Filter by new product success rate**\n```\nFind niches for \"phone case\" where the 180-day new product launch success rate is above 20%.\n```\nParameters: `{\"keyword\": \"phone case\", \"launchRateT180Min\": 0.2}`\n\n**7. Low return rate niches**\n```\nShow review topics for \"water bottle\" niches with return rates below 5%.\n```\nParameters: `{\"keyword\": \"water bottle\", \"returnRateT360Max\": 0.05}`\n\n## Display Rules\n\n1. **Present data clearly**: Show review topics in a well-organized table. Include the niche name, review type (positive/negative), topic, mention percentage, and a review example\n2. **Percentage formatting**: Convert 0-1 scale values to percentages for display (e.g., 0.15 -> 15%)\n3. **Sentiment separation**: When presenting results, group or clearly label positive vs. negative reviews so users can quickly identify opportunities and pain points\n4. **Actionable insight framing**: While showing data objectively, highlight high-mention-percentage negative reviews as potential product improvement opportunities, and high-mention-percentage positive reviews as features to emphasize in listings\n5. **Volume notice**: When results are large, show the most relevant data first and remind users about pagination options\n6. **Error handling**: When a query fails, explain the reason and suggest adjusting the keyword or filter criteria\n7. **Language reminder**: If a user provides a keyword in the wrong language for the target marketplace, remind them to use the marketplace's native language (English for US, German for DE, Japanese for JP)\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Consumer review and sentiment analysis within Amazon niche markets:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"What do customers say about XX\" | Niche review topic lookup |\n| \"Customer pain points for XX\" | Negative review analysis |\n| \"What features do buyers love in XX\" | Positive review analysis |\n| \"Review sentiment for XX niche\" | Full sentiment breakdown |\n| \"Consumer demand insights for XX\" | Demand signal extraction from reviews |\n| \"Common complaints about XX products\" | Negative topic mining |\n| \"What makes XX products popular\" | Positive topic mining |\n| \"Niche market review analysis\" | General niche review exploration |\n\n**Not applicable** -- Needs beyond niche review analysis:\n- Individual ASIN review analysis (this tool works at the niche/market level)\n- Keyword search volume trends without review context (use ABA data tools instead)\n- Product listing optimization or copywriting\n- Advertising strategy and PPC management\n- Sales estimation or revenue forecasting\n\n**Boundary judgment**: When users say \"market research\" or \"product opportunity\", if their intent focuses on understanding consumer sentiment, review topics, and pain points within a niche market, this skill applies. If they are asking about search volume trends, pricing strategy, or sales data without review context, it does not apply.\n\n## 积分消耗规则\n\n消耗 9 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\n\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783944674042\n}\n\nFile v1.0.4:references/api.md\n\n# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\r\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\r\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\r\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\r\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\r\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\r\n\r\n**销售伙伴年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\r\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\r\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\r\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\r\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\r\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\r\n\r\n**新品与退货指标**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值 |\r\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值 |\r\n| newProductRateT180 | number | 新商品占比（180天统计）最小值 |\r\n| returnRateT360Min | number | 退货率（360天统计）最小值 |\r\n| returnRateT360Max | number | 退货率（360天统计）最大值 |\r\n\r\n**广告**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| cpcMediumMin | number | CPC（当前）最小值 |\r\n| cpcMediumMax | number | CPC（当前）最大值 |\r\n\r\n**系统字段**（可忽略，由系统自动处理）：\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总数 |\r\n| data | array | 细分市场评论列表（详见下方数据项字段） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n| title | string | 标题 |\r\n\r\n### 数据项字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheName | string | 细分市场名称 |\r\n| keyword | string | 关键词 |\r\n| reviewType | string | 评论类型（值范围为【正面评论】、【负面评论】） |\r\n| topic | string | 评论主题 |\r\n| percentOfMentions | number | 占比（数值范围为0-1，代表0%-100%） |\r\n| reviewExample | string | 评论样例 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n    \"errcode\": 401,\r\n    \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"yoga mat\",\r\n    \"countryCode\": \"US\",\r\n    \"pageSize\": 20,\r\n    \"sortField\": \"unitsSoldT7\",\r\n    \"sortType\": \"desc\"\r\n  }'\r\n```\r\n\r\n### 带筛选条件的示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"wireless earbuds\",\r\n    \"countryCode\": \"US\",\r\n    \"searchVolumeT7Min\": 5000,\r\n    \"top5BrandsClickShareMax\": 0.5,\r\n    \"sortField\": \"demand\",\r\n    \"sortType\": \"desc\",\r\n    \"page\": 1,\r\n    \"pageSize\": 50\r\n  }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n  \"skillName\": \"linkfox-xxx-xxx\",\r\n  \"sentiment\": \"POSITIVE\",\r\n  \"category\": \"OTHER\",\r\n  \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\r\n\r\n**Field rules:**\r\n- `skillName`: Use this skill's `name` from the YAML frontmatter\r\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\r\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\r\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nGuides an agent to query LinkFox/Jiimore Amazon niche-market review data by keyword and summarize consumer sentiment, pain points, review topics, and demand signals. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nAmazon sellers, e-commerce operators, and market researchers use this skill to retrieve niche-level review sentiment for a keyword and identify customer pain points, positive themes, and product improvement opportunities. It is intended for supported Amazon marketplaces and should not be used for individual ASIN review analysis or unrelated advertising, pricing, or sales-forecasting tasks. <br>\n\n### Deployment Geography for Use: <br>\nGlobal, with marketplace data limited to Amazon US, JP, and DE. <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill sends keywords, API credentials, and session or app metadata to LinkFox-configured endpoints. <br>\nMitigation: Use only trusted LinkFox gateway settings, avoid sensitive keywords unless necessary, and confirm the API key is intended for this data-sharing context. <br>\nRisk: The skill stores full API responses and cached responses locally, which may retain market research data longer than expected. <br>\nMitigation: Review saved LinkFox data locations after use and delete response or cache files that should not remain in the workspace. <br>\nRisk: Onboarding and feedback flows may involve remote downloads or submissions outside the main review-query workflow. <br>\nMitigation: Require explicit user approval before any onboarding download or feedback submission. <br>\nRisk: Each API call consumes LinkFox credits, and repeated or exploratory queries may create unexpected cost. <br>\nMitigation: Explain credit use before additional searches and reuse cached same-parameter results when appropriate. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword) <br>\n- [Jiimore Amazon Niche Review API Reference](references/api.md) <br>\n- [LinkFox Skills](https://skill.linkfox.com/) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with JSON parameters, shell commands, and saved JSON response files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Full responses are saved locally as JSON; small responses may also print in full, while larger responses are summarized unless inline output is requested.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.3: 5 files, 15238 bytes\n\nFiles: references/api.md (9590b), scripts/jiimore_get_niche_review.py (13217b), skill-card.md (2462b), SKILL.md (12885b), _meta.json (164b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: linkfox-jiimore-get-niche-review-from-keyword\r\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\r\n---\r\n\r\n# Jiimore Niche Review from Keyword\r\n\r\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\r\n\r\n## Core Concepts\r\n\r\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\r\n\r\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\r\n\r\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\r\n\r\n## Supported Marketplaces\r\n\r\nUS (United States), JP (Japan), DE (Germany)\r\n\r\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## Parameter Guide\r\n\r\n### Required Parameter\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\r\n\r\n### Marketplace & Pagination\r\n\r\n| Parameter | Type | Default | Description |\r\n|-----------|------|---------|-------------|\r\n| countryCode | string | US | Country code: US, JP, or DE |\r\n| page | integer | 1 | Page number (starting from 1) |\r\n| pageSize | integer | 50 | Results per page (10-100) |\r\n\r\n### Sorting\r\n\r\n| Parameter | Type | Default | Description |\r\n|-----------|------|---------|-------------|\r\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\r\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\r\n\r\n**Sortable Fields**:\r\n\r\n| Field | Description |\r\n|-------|-------------|\r\n| unitsSoldT7 | Units sold (7-day) |\r\n| searchVolumeT7 | Search volume (7-day) |\r\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\r\n| clickConversionRateT7 | Click conversion rate (7-day) |\r\n| searchConversionRateT7 | Search conversion rate (7-day) |\r\n| clickCountT7 | Click count (7-day) |\r\n| demand | Demand score |\r\n| avgPrice | Average price |\r\n| maximumPrice | Maximum price |\r\n| minimumPrice | Minimum price |\r\n| productCount | Product count |\r\n| brandCount | Brand count |\r\n| top5BrandsClickShare | Top 5 brands click share |\r\n| top5ProductsClickShare | Top 5 products click share |\r\n| clickCountT90 | Click count (90-day) |\r\n| clickConversionRateT90 | Click conversion rate (90-day) |\r\n| searchConversionRateT90 | Search conversion rate (90-day) |\r\n| searchVolumeT90 | Search volume (90-day) |\r\n| unitsSoldT90 | Units sold (90-day) |\r\n| unitsSoldGrowthT90 | Units sold growth (90-day) |\r\n| searchVolumeGrowthT90 | Search volume growth (90-day) |\r\n| returnRateT360 | Return rate (360-day) |\r\n| newProductsLaunchedT180 | New products launched (180-day) |\r\n| successfulLaunchesT180 | Successful launches (180-day) |\r\n| launchRateT180 | Launch success rate (180-day) |\r\n| acos | ACOS |\r\n| profitRate50 | Profit rate at 50% organic orders |\r\n\r\n### Niche Filtering Parameters\r\n\r\nAll filter parameters follow a min/max range pattern. Values for percentage-based fields use a 0-1 scale (e.g., 0.05 = 5%).\r\n\r\n**Product & Brand Metrics**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| productCountMin / productCountMax | integer | Product count range |\r\n| brandCountMin / brandCountMax | integer | Brand count range |\r\n| avgPriceMin / avgPriceMax | number | Average price range |\r\n\r\n**Sales & Search Volume**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| unitsSoldT7Min / unitsSoldT7Max | integer | Units sold (7-day) range |\r\n| searchVolumeT7Min / searchVolumeT7Max | integer | Search volume (7-day) range |\r\n| clickCountT7Min / clickCountT7Max | integer | Click count (7-day) range |\r\n\r\n**Conversion & Click Rates** (0-1 scale):\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| clickConversionRateT7Min / clickConversionRateT7Max | number | Click conversion rate (7-day) range |\r\n\r\n**Market Concentration** (0-1 scale):\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| top5BrandsClickShareMin / top5BrandsClickShareMax | number | Top 5 brands click share range |\r\n| top5ProductsClickShareMin / top5ProductsClickShareMax | number | Top 5 products click share range |\r\n| sponsoredProductsPercentageMin / sponsoredProductsPercentageMax | number | SP ad percentage range |\r\n\r\n**Brand & Seller Age**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| avgBrandAgeMin / avgBrandAgeMax | number | Average brand age (current) |\r\n| avgBrandAgeQoqMin / avgBrandAgeQoqMax | number | Average brand age (90-day) |\r\n| avgBrandAgeYoyMin / avgBrandAgeYoyMax | number | Average brand age (360-day) |\r\n| avgSellingPartnerAgeMin / avgSellingPartnerAgeMax | number | Average seller age (current) |\r\n| avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax | number | Average seller age (90-day) |\r\n| avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax | number | Average seller age (360-day) |\r\n\r\n**New Product & Return Metrics** (0-1 scale):\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| launchRateT180Min / launchRateT180Max | number | Launch success rate (180-day) range |\r\n| newProductRateT180 | number | New product percentage (180-day) min |\r\n| returnRateT360Min / returnRateT360Max | number | Return rate (360-day) range |\r\n\r\n**Advertising**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| cpcMediumMin / cpcMediumMax | number | CPC (current) range |\r\n\r\n## Usage Examples\r\n\r\n**1. Basic niche review lookup for a keyword**\r\n```\r\nAnalyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace.\r\n```\r\nParameters: `{\"keyword\": \"yoga mat\", \"countryCode\": \"US\"}`\r\n\r\n**2. Find niche reviews with high search volume**\r\n```\r\nShow me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000.\r\n```\r\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"searchVolumeT7Min\": 10000}`\r\n\r\n**3. Low competition niches with review insights**\r\n```\r\nFind review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share.\r\n```\r\nParameters: `{\"keyword\": \"pet bed\", \"countryCode\": \"US\", \"top5BrandsClickShareMax\": 0.3}`\r\n\r\n**4. Japanese market niche reviews**\r\n```\r\nAnalyze niche reviews for wireless earbuds on the Japan marketplace.\r\n```\r\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"JP\"}`\r\n\r\n**5. Sorted by demand score**\r\n```\r\nShow niche reviews for \"kitchen organizer\" sorted by demand score in descending order.\r\n```\r\nParameters: `{\"keyword\": \"kitchen organizer\", \"sortField\": \"demand\", \"sortType\": \"desc\"}`\r\n\r\n**6. Filter by new product success rate**\r\n```\r\nFind niches for \"phone case\" where the 180-day new product launch success rate is above 20%.\r\n```\r\nParameters: `{\"keyword\": \"phone case\", \"launchRateT180Min\": 0.2}`\r\n\r\n**7. Low return rate niches**\r\n```\r\nShow review topics for \"water bottle\" niches with return rates below 5%.\r\n```\r\nParameters: `{\"keyword\": \"water bottle\", \"returnRateT360Max\": 0.05}`\r\n\r\n## Display Rules\r\n\r\n1. **Present data clearly**: Show review topics in a well-organized table. Include the niche name, review type (positive/negative), topic, mention percentage, and a review example\r\n2. **Percentage formatting**: Convert 0-1 scale values to percentages for display (e.g., 0.15 -> 15%)\r\n3. **Sentiment separation**: When presenting results, group or clearly label positive vs. negative reviews so users can quickly identify opportunities and pain points\r\n4. **Actionable insight framing**: While showing data objectively, highlight high-mention-percentage negative reviews as potential product improvement opportunities, and high-mention-percentage positive reviews as features to emphasize in listings\r\n5. **Volume notice**: When results are large, show the most relevant data first and remind users about pagination options\r\n6. **Error handling**: When a query fails, explain the reason and suggest adjusting the keyword or filter criteria\r\n7. **Language reminder**: If a user provides a keyword in the wrong language for the target marketplace, remind them to use the marketplace's native language (English for US, German for DE, Japanese for JP)\r\n## User Expression & Scenario Quick Reference\r\n\r\n**Applicable** -- Consumer review and sentiment analysis within Amazon niche markets:\r\n\r\n| User Says | Scenario |\r\n|-----------|----------|\r\n| \"What do customers say about XX\" | Niche review topic lookup |\r\n| \"Customer pain points for XX\" | Negative review analysis |\r\n| \"What features do buyers love in XX\" | Positive review analysis |\r\n| \"Review sentiment for XX niche\" | Full sentiment breakdown |\r\n| \"Consumer demand insights for XX\" | Demand signal extraction from reviews |\r\n| \"Common complaints about XX products\" | Negative topic mining |\r\n| \"What makes XX products popular\" | Positive topic mining |\r\n| \"Niche market review analysis\" | General niche review exploration |\r\n\r\n**Not applicable** -- Needs beyond niche review analysis:\r\n- Individual ASIN review analysis (this tool works at the niche/market level)\r\n- Keyword search volume trends without review context (use ABA data tools instead)\r\n- Product listing optimization or copywriting\r\n- Advertising strategy and PPC management\r\n- Sales estimation or revenue forecasting\r\n\r\n**Boundary judgment**: When users say \"market research\" or \"product opportunity\", if their intent focuses on understanding consumer sentiment, review topics, and pain points within a niche market, this skill applies. If they are asking about search volume trends, pricing strategy, or sales data without review context, it does not apply.\r\n\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\r\n\r\n\r\n---\r\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1783336811298\n}\n\nFile v1.0.3:references/api.md\n\n# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\r\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\r\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\r\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\r\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\r\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\r\n\r\n**销售伙伴年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\r\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\r\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\r\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\r\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\r\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\r\n\r\n**新品与退货指标**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值 |\r\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值 |\r\n| newProductRateT180 | number | 新商品占比（180天统计）最小值 |\r\n| returnRateT360Min | number | 退货率（360天统计）最小值 |\r\n| returnRateT360Max | number | 退货率（360天统计）最大值 |\r\n\r\n**广告**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| cpcMediumMin | number | CPC（当前）最小值 |\r\n| cpcMediumMax | number | CPC（当前）最大值 |\r\n\r\n**系统字段**（可忽略，由系统自动处理）：\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总数 |\r\n| data | array | 细分市场评论列表（详见下方数据项字段） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n| title | string | 标题 |\r\n\r\n### 数据项字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheName | string | 细分市场名称 |\r\n| keyword | string | 关键词 |\r\n| reviewType | string | 评论类型（值范围为【正面评论】、【负面评论】） |\r\n| topic | string | 评论主题 |\r\n| percentOfMentions | number | 占比（数值范围为0-1，代表0%-100%） |\r\n| reviewExample | string | 评论样例 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n    \"errcode\": 401,\r\n    \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"yoga mat\",\r\n    \"countryCode\": \"US\",\r\n    \"pageSize\": 20,\r\n    \"sortField\": \"unitsSoldT7\",\r\n    \"sortType\": \"desc\"\r\n  }'\r\n```\r\n\r\n### 带筛选条件的示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"wireless earbuds\",\r\n    \"countryCode\": \"US\",\r\n    \"searchVolumeT7Min\": 5000,\r\n    \"top5BrandsClickShareMax\": 0.5,\r\n    \"sortField\": \"demand\",\r\n    \"sortType\": \"desc\",\r\n    \"page\": 1,\r\n    \"pageSize\": 50\r\n  }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n  \"skillName\": \"linkfox-xxx-xxx\",\r\n  \"sentiment\": \"POSITIVE\",\r\n  \"category\": \"OTHER\",\r\n  \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\r\n\r\n**Field rules:**\r\n- `skillName`: Use this skill's `name` from the YAML frontmatter\r\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\r\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\r\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.3:skill-card.md\n\n## Description: <br>\nJiimore-细分市场评论 analyzes Amazon niche-market customer reviews to surface sentiment, review topics, pain points, and demand signals for supported marketplaces. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nAmazon sellers and market researchers use this skill to query Jiimore-powered niche review data and understand what customers praise, complain about, and repeatedly mention in Amazon niche markets. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Queries, filters, session metadata, and feedback context may be sent to LinkFox services. <br>\nMitigation: Use the skill only with a trusted LinkFox endpoint and confirm the user's intent before running queries or submitting feedback. <br>\nRisk: The skill consumes credits, and broad activation rules could trigger paid queries or feedback reporting without clear user confirmation. <br>\nMitigation: Prefer explicit confirmation for API calls, rely on the 24-hour cache for repeated parameter sets, and explain that retries or changed filters may create additional cost. <br>\nRisk: Full API responses are stored locally in LinkFox session data. <br>\nMitigation: Avoid submitting sensitive keywords or private market-research context, and manage retained response files according to the user's data-handling policy. <br>\n\n\n## Reference(s): <br>\n- [API reference](references/api.md) <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance, tabular summaries, shell command examples, and saved JSON API responses] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Full responses are saved under LinkFox session data; large responses are summarized unless inline output is requested.] <br>\n\n## Skill Version(s): <br>\n1.0.3 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.2: 5 files, 15196 bytes\n\nFiles: references/api.md (9590b), scripts/jiimore_get_niche_review.py (13217b), skill-card.md (2442b), SKILL.md (12885b), _meta.json (164b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: linkfox-jiimore-get-niche-review-from-keyword\r\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\r\n---\r\n\r\n# Jiimore Niche Review from Keyword\r\n\r\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\r\n\r\n## Core Concepts\r\n\r\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\r\n\r\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\r\n\r\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\r\n\r\n## Supported Marketplaces\r\n\r\nUS (United States), JP (Japan), DE (Germany)\r\n\r\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## Parameter Guide\r\n\r\n### Required Parameter\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\r\n\r\n### Marketplace & Pagination\r\n\r\n| Parameter | Type | Default | Description |\r\n|-----------|------|---------|-------------|\r\n| countryCode | string | US | Country code: US, JP, or DE |\r\n| page | integer | 1 | Page number (starting from 1) |\r\n| pageSize | integer | 50 | Results per page (10-100) |\r\n\r\n### Sorting\r\n\r\n| Parameter | Type | Default | Description |\r\n|-----------|------|---------|-------------|\r\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\r\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\r\n\r\n**Sortable Fields**:\r\n\r\n| Field | Description |\r\n|-------|-------------|\r\n| unitsSoldT7 | Units sold (7-day) |\r\n| searchVolumeT7 | Search volume (7-day) |\r\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\r\n| clickConversionRateT7 | Click conversion rate (7-day) |\r\n| searchConversionRateT7 | Search conversion rate (7-day) |\r\n| clickCountT7 | Click count (7-day) |\r\n| demand | Demand score |\r\n| avgPrice | Average price |\r\n| maximumPrice | Maximum price |\r\n| minimumPrice | Minimum price |\r\n| productCount | Product count |\r\n| brandCount | Brand count |\r\n| top5BrandsClickShare | Top 5 brands click share |\r\n| top5ProductsClickShare | Top 5 products click share |\r\n| clickCountT90 | Click count (90-day) |\r\n| clickConversionRateT90 | Click conversion rate (90-day) |\r\n| searchConversionRateT90 | Search conversion rate (90-day) |\r\n| searchVolumeT90 | Search volume (90-day) |\r\n| unitsSoldT90 | Units sold (90-day) |\r\n| unitsSoldGrowthT90 | Units sold growth (90-day) |\r\n| searchVolumeGrowthT90 | Search volume growth (90-day) |\r\n| returnRateT360 | Return rate (360-day) |\r\n| newProductsLaunchedT180 | New products launched (180-day) |\r\n| successfulLaunchesT180 | Successful launches (180-day) |\r\n| launchRateT180 | Launch success rate (180-day) |\r\n| acos | ACOS |\r\n| profitRate50 | Profit rate at 50% organic orders |\r\n\r\n### Niche Filtering Parameters\r\n\r\nAll filter parameters follow a min/max range pattern. Values for percentage-based fields use a 0-1 scale (e.g., 0.05 = 5%).\r\n\r\n**Product & Brand Metrics**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| productCountMin / productCountMax | integer | Product count range |\r\n| brandCountMin / brandCountMax | integer | Brand count range |\r\n| avgPriceMin / avgPriceMax | number | Average price range |\r\n\r\n**Sales & Search Volume**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| unitsSoldT7Min / unitsSoldT7Max | integer | Units sold (7-day) range |\r\n| searchVolumeT7Min / searchVolumeT7Max | integer | Search volume (7-day) range |\r\n| clickCountT7Min / clickCountT7Max | integer | Click count (7-day) range |\r\n\r\n**Conversion & Click Rates** (0-1 scale):\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| clickConversionRateT7Min / clickConversionRateT7Max | number | Click conversion rate (7-day) range |\r\n\r\n**Market Concentration** (0-1 scale):\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| top5BrandsClickShareMin / top5BrandsClickShareMax | number | Top 5 brands click share range |\r\n| top5ProductsClickShareMin / top5ProductsClickShareMax | number | Top 5 products click share range |\r\n| sponsoredProductsPercentageMin / sponsoredProductsPercentageMax | number | SP ad percentage range |\r\n\r\n**Brand & Seller Age**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| avgBrandAgeMin / avgBrandAgeMax | number | Average brand age (current) |\r\n| avgBrandAgeQoqMin / avgBrandAgeQoqMax | number | Average brand age (90-day) |\r\n| avgBrandAgeYoyMin / avgBrandAgeYoyMax | number | Average brand age (360-day) |\r\n| avgSellingPartnerAgeMin / avgSellingPartnerAgeMax | number | Average seller age (current) |\r\n| avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax | number | Average seller age (90-day) |\r\n| avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax | number | Average seller age (360-day) |\r\n\r\n**New Product & Return Metrics** (0-1 scale):\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| launchRateT180Min / launchRateT180Max | number | Launch success rate (180-day) range |\r\n| newProductRateT180 | number | New product percentage (180-day) min |\r\n| returnRateT360Min / returnRateT360Max | number | Return rate (360-day) range |\r\n\r\n**Advertising**:\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| cpcMediumMin / cpcMediumMax | number | CPC (current) range |\r\n\r\n## Usage Examples\r\n\r\n**1. Basic niche review lookup for a keyword**\r\n```\r\nAnalyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace.\r\n```\r\nParameters: `{\"keyword\": \"yoga mat\", \"countryCode\": \"US\"}`\r\n\r\n**2. Find niche reviews with high search volume**\r\n```\r\nShow me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000.\r\n```\r\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"searchVolumeT7Min\": 10000}`\r\n\r\n**3. Low competition niches with review insights**\r\n```\r\nFind review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share.\r\n```\r\nParameters: `{\"keyword\": \"pet bed\", \"countryCode\": \"US\", \"top5BrandsClickShareMax\": 0.3}`\r\n\r\n**4. Japanese market niche reviews**\r\n```\r\nAnalyze niche reviews for wireless earbuds on the Japan marketplace.\r\n```\r\nParameters: `{\"keyword\": \"wireless earbuds\", \"countryCode\": \"JP\"}`\r\n\r\n**5. Sorted by demand score**\r\n```\r\nShow niche reviews for \"kitchen organizer\" sorted by demand score in descending order.\r\n```\r\nParameters: `{\"keyword\": \"kitchen organizer\", \"sortField\": \"demand\", \"sortType\": \"desc\"}`\r\n\r\n**6. Filter by new product success rate**\r\n```\r\nFind niches for \"phone case\" where the 180-day new product launch success rate is above 20%.\r\n```\r\nParameters: `{\"keyword\": \"phone case\", \"launchRateT180Min\": 0.2}`\r\n\r\n**7. Low return rate niches**\r\n```\r\nShow review topics for \"water bottle\" niches with return rates below 5%.\r\n```\r\nParameters: `{\"keyword\": \"water bottle\", \"returnRateT360Max\": 0.05}`\r\n\r\n## Display Rules\r\n\r\n1. **Present data clearly**: Show review topics in a well-organized table. Include the niche name, review type (positive/negative), topic, mention percentage, and a review example\r\n2. **Percentage formatting**: Convert 0-1 scale values to percentages for display (e.g., 0.15 -> 15%)\r\n3. **Sentiment separation**: When presenting results, group or clearly label positive vs. negative reviews so users can quickly identify opportunities and pain points\r\n4. **Actionable insight framing**: While showing data objectively, highlight high-mention-percentage negative reviews as potential product improvement opportunities, and high-mention-percentage positive reviews as features to emphasize in listings\r\n5. **Volume notice**: When results are large, show the most relevant data first and remind users about pagination options\r\n6. **Error handling**: When a query fails, explain the reason and suggest adjusting the keyword or filter criteria\r\n7. **Language reminder**: If a user provides a keyword in the wrong language for the target marketplace, remind them to use the marketplace's native language (English for US, German for DE, Japanese for JP)\r\n## User Expression & Scenario Quick Reference\r\n\r\n**Applicable** -- Consumer review and sentiment analysis within Amazon niche markets:\r\n\r\n| User Says | Scenario |\r\n|-----------|----------|\r\n| \"What do customers say about XX\" | Niche review topic lookup |\r\n| \"Customer pain points for XX\" | Negative review analysis |\r\n| \"What features do buyers love in XX\" | Positive review analysis |\r\n| \"Review sentiment for XX niche\" | Full sentiment breakdown |\r\n| \"Consumer demand insights for XX\" | Demand signal extraction from reviews |\r\n| \"Common complaints about XX products\" | Negative topic mining |\r\n| \"What makes XX products popular\" | Positive topic mining |\r\n| \"Niche market review analysis\" | General niche review exploration |\r\n\r\n**Not applicable** -- Needs beyond niche review analysis:\r\n- Individual ASIN review analysis (this tool works at the niche/market level)\r\n- Keyword search volume trends without review context (use ABA data tools instead)\r\n- Product listing optimization or copywriting\r\n- Advertising strategy and PPC management\r\n- Sales estimation or revenue forecasting\r\n\r\n**Boundary judgment**: When users say \"market research\" or \"product opportunity\", if their intent focuses on understanding consumer sentiment, review topics, and pain points within a niche market, this skill applies. If they are asking about search volume trends, pricing strategy, or sales data without review context, it does not apply.\r\n\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\r\n\r\n\r\n---\r\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1783066738349\n}\n\nFile v1.0.2:references/api.md\n\n# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\r\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\r\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\r\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\r\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\r\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\r\n\r\n**销售伙伴年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\r\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\r\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\r\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\r\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\r\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\r\n\r\n**新品与退货指标**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值 |\r\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值 |\r\n| newProductRateT180 | number | 新商品占比（180天统计）最小值 |\r\n| returnRateT360Min | number | 退货率（360天统计）最小值 |\r\n| returnRateT360Max | number | 退货率（360天统计）最大值 |\r\n\r\n**广告**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| cpcMediumMin | number | CPC（当前）最小值 |\r\n| cpcMediumMax | number | CPC（当前）最大值 |\r\n\r\n**系统字段**（可忽略，由系统自动处理）：\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总数 |\r\n| data | array | 细分市场评论列表（详见下方数据项字段） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n| title | string | 标题 |\r\n\r\n### 数据项字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheName | string | 细分市场名称 |\r\n| keyword | string | 关键词 |\r\n| reviewType | string | 评论类型（值范围为【正面评论】、【负面评论】） |\r\n| topic | string | 评论主题 |\r\n| percentOfMentions | number | 占比（数值范围为0-1，代表0%-100%） |\r\n| reviewExample | string | 评论样例 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n    \"errcode\": 401,\r\n    \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"yoga mat\",\r\n    \"countryCode\": \"US\",\r\n    \"pageSize\": 20,\r\n    \"sortField\": \"unitsSoldT7\",\r\n    \"sortType\": \"desc\"\r\n  }'\r\n```\r\n\r\n### 带筛选条件的示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheReviewFromKeyword \\\r\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n    \"keyword\": \"wireless earbuds\",\r\n    \"countryCode\": \"US\",\r\n    \"searchVolumeT7Min\": 5000,\r\n    \"top5BrandsClickShareMax\": 0.5,\r\n    \"sortField\": \"demand\",\r\n    \"sortType\": \"desc\",\r\n    \"page\": 1,\r\n    \"pageSize\": 50\r\n  }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n  \"skillName\": \"linkfox-xxx-xxx\",\r\n  \"sentiment\": \"POSITIVE\",\r\n  \"category\": \"OTHER\",\r\n  \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\r\n\r\n**Field rules:**\r\n- `skillName`: Use this skill's `name` from the YAML frontmatter\r\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\r\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\r\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.2:skill-card.md\n\n## Description: <br>\nJiimore Niche Review helps agents query Jiimore-powered Amazon niche review data and summarize consumer sentiment, pain points, and review themes for US, JP, or DE marketplaces. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal Amazon sellers, e-commerce operators, and market researchers use this skill through an agent to retrieve niche-level Amazon review topics, sentiment, mention percentages, and examples for product research and improvement decisions. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can write full API responses outside the documented workspace fallback path. <br>\nMitigation: Review the configured output directory and avoid running the skill with confidential product research or customer data unless that storage location is acceptable. <br>\nRisk: The skill can send automatic feedback content to a separate service without asking first. <br>\nMitigation: Review feedback behavior before installation and disable or avoid use where user comments, customer data, or proprietary research should not be reported externally. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill listing](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword) <br>\n- [API reference](references/api.md) <br>\n- [LinkFox Skills](https://skill.linkfox.com/) <br>\n- [LinkFox authorization guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, shell commands, API calls, files, markdown] <br>\n**Output Format:** [Markdown guidance with JSON API parameters, command examples, and summarized or full JSON results] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [The script can cache identical requests for 24 hours and writes full API responses to a LinkFox session data directory while printing summaries for larger responses.] <br>\n\n## Skill Version(s): <br>\n1.0.2 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.1: 5 files, 15165 bytes\n\nFiles: references/api.md (9591b), scripts/jiimore_get_niche_review.py (13219b), skill-card.md (2476b), SKILL.md (12885b), _meta.json (164b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: linkfox-jiimore-get-niche-review-from-keyword\r\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\r\n---\r\n\r\n# Jiimore Niche Review from Keyword\r\n\r\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\r\n\r\n## Core Concepts\r\n\r\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\r\n\r\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\r\n\r\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\r\n\r\n## Supported Marketplaces\r\n\r\nUS (United States), JP (Japan), DE (Germany)\r\n\r\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## Parameter Guide\r\n\r\n### Required Parameter\r\n\r\n| Parameter | Type | Description |\r\n|-----------|------|-------------|\r\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\r\n\r\n### Marketplace & Pagination\r\n\r\n| Parameter | Type | Default | Description |\r\n|-----------|------|---------|-------------|\r\n| countryCode | string | US | Country code: US, JP, or DE |\r\n| page | integer | 1 | Page number (starting from 1) |\r\n| pageSize | integer | 50 | Results per page (10-100) |\r\n\r\n### Sorting\r\n\r\n| Parameter | Type | Default | Description |\r\n|-----------|------|---------|-------------|\r\n| sortField | string | unitsSoldT7 | Field to sort by (see Sortable Fields below) |\r\n| sortType | string | desc | Sort direction: `desc` (descending) or `asc` (ascending) |\r\n\r\n**Sortable Fields**:\r\n\r\n| Field | Description |\r\n|-------|-------------|\r\n| unitsSoldT7 | Units sold (7-day) |\r\n| searchVolumeT7 | Search volume (7-day) |\r\n| searchVolumeGrowthT7 | Search volume growth (7-day) |\r\n| clickConversionRateT7 | Click conversion rate (7-day) |\r\n| searchConversionRateT7 | Search conversion rate (7-day) |\r\n| clickCountT7 | Click count (7-day) |\r\n| demand | Demand score |\r\n| avgPrice | Average price |\r\n| maximumPrice | Maximum price |\r\n| minimumPrice | Minimum price |\r\n| productCount | Product count |\r\n| brandCount | Brand count |\r\n| top5BrandsClickShare | Top 5 brands click share |\r\n| top5ProductsClickShare | Top 5 products click share |\r\n| clickCountT90 | Click count (90-day) |\r\n| clickConversionRateT90 | Click conversion rate (90-day) |\r\n| searchConversionRateT90 | Search conversion rate (90-day) |\r\n| searchVolumeT90 | Search volume (90-day) |\r\n| unitsSoldT90 | Units sold (90-day) |\r\n| unitsSoldGrowthT90","readmeExcerpt":"Skill: Jiimore-细分市场评论 Owner: linkfox-ai Summary: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T05:20:00.058Z | u","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"Analyze customer reviews in niche markets related to \"yoga mat\" on the US marketplace."},{"language":"text","snippet":"Show me niche market reviews for \"wireless earbuds\" where 7-day search volume is above 10000."},{"language":"text","snippet":"Find review insights for \"pet bed\" niches where top 5 brands hold less than 30% click share."},{"language":"text","snippet":"Analyze niche reviews for wireless earbuds on the Japan marketplace."},{"language":"text","snippet":"Show niche reviews for \"kitchen organizer\" sorted by demand score in descending order."},{"language":"text","snippet":"Find niches for \"phone case\" where the 180-day new product launch success rate is above 20%."}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-jiimore-get-niche-review-from-keyword\ndescription: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。\n---\n\n# Jiimore Niche Review from Keyword\n\nThis skill guides you on how to query and analyze Amazon niche market review data powered by Jiimore, helping Amazon sellers uncover consumer sentiment, pain points, and real demand signals from product reviews within niche markets.\n\n## Core Concepts\n\nNiche Review Analysis aggregates and categorizes customer reviews across products in an Amazon niche market. Given a keyword, the system identifies the relevant niche markets, extracts review topics, classifies them as positive or negative, and shows how frequently each topic is mentioned. This enables sellers to understand what customers love, what frustrates them, and where product improvement opportunities exist.\n\n**Review types**: Each review entry is classified as either \"positive\" or \"negative\", reflecting the overall sentiment of that review topic.\n\n**Mention percentage**: The `percentOfMentions` value (0-1 scale, representing 0%-100%) indicates how frequently a particular topic appears across all reviews in the niche. A higher percentage means more customers are talking about that topic.\n\n## Supported Marketplaces\n\nUS (United States), JP (Japan), DE (Germany)\n\nDefault marketplace is **US**. Use US when the user does not specify a marketplace.\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheReviewFromKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameter Guide\n\n### Required Parameter\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| keyword | string | The search keyword (max 1000 chars). Must be in the language of the target marketplace (English for US, German for DE, Japanese for JP) |\n\n### Marketplace & Pagination\n\n| Parameter | Type | De"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-jiimore-get-niche-review-from-keyword\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789363200058\n}"},{"path":"references/api.md","content":"# 极目-亚马逊-细分市场评论 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheReviewFromKeyword`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n### 必填参数\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 是 | 关键词（必填，请使用对应站点的语言，如美国站用英文，德国站用德文），最大长度1000字符 |\r\n\r\n### 站点与分页\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\r\n| page | integer | 否 | 1 | 页码（从1开始） |\r\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\r\n\r\n### 排序\r\n\r\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\r\n|------|------|------|--------|------|\r\n| sortField | string | 否 | unitsSoldT7 | 排序字段，可选值：`clickConversionRateT7`（7天点击转化率）、`demand`（需求得分）、`avgPrice`（商品均价）、`maximumPrice`（商品最高价）、`minimumPrice`（商品最低价）、`productCount`（商品数量）、`searchConversionRateT7`（7天搜索转化率）、`searchVolumeT7`（7天搜索量）、`unitsSoldT7`（7天销量）、`searchVolumeGrowthT7`（搜索增长率）、`clickCountT90`（90天点击量）、`clickCountT7`（周点击量）、`brandCount`（品牌数量）、`top5BrandsClickShare`（TOP5品牌份额）、`newProductsLaunchedT180`（180d新品成功率-发布数）、`successfulLaunchesT180`（180d新品成功率-新品数）、`launchRateT180`（180d新品成功率-发布率）、`top5ProductsClickShare`（top5商品点击份额）、`returnRateT360`（退货率）、`clickConversionRateT90`（90天点击转化率）、`searchConversionRateT90`（90天搜索转化率）、`searchVolumeT90`（90天搜索量）、`unitsSoldT90`（90天销量）、`unitsSoldGrowthT90`（90天销量增长率）、`searchVolumeGrowthT90`（90天搜索增长率）、`acos`、`profitRate50`（50%自然单的利润率） |\r\n| sortType | string | 否 | desc | 排序方式，可选值：`desc`（降序）、`asc`（升序） |\r\n\r\n### 细分市场筛选（均为选填）\r\n\r\n**商品与品牌指标**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCountMin | integer | 商品数量（当前）最小值 |\r\n| productCountMax | integer | 商品数量（当前）最大值 |\r\n| brandCountMin | integer | 品牌数量最小值 |\r\n| brandCountMax | integer | 品牌数量最大值 |\r\n| avgPriceMin | number | 平均价格（当前）最小值 |\r\n| avgPriceMax | number | 平均价格（当前）最大值 |\r\n\r\n**销量与搜索量**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\r\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\r\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\r\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\r\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\r\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\r\n\r\n**转化率**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值 |\r\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值 |\r\n\r\n**市场集中度**（数值范围为0-1，代表0%-100%）：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值 |\r\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值 |\r\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值 |\r\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值 |\r\n| sponsoredProductsPercentageMin | number | SP广告占比最小值 |\r\n| sponsoredProductsPercentageMax | number | SP广告占比最大值 |\r\n\r\n**品牌年龄**：\r\n\r\n| 参数 | 类型 | 说明 |\r\n|------|------|------|\r\n|"},{"path":"references/onboarding.md","content":"# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。"},{"path":"skill-card.md","content":"## Description:\n\nJiimore analyzes Amazon niche-market reviews from a keyword to surface sentiment, recurring topics, customer pain points, and review examples for supported marketplaces.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal Amazon sellers and market researchers use this skill to request Jiimore niche review data for a keyword and turn returned review topics into consumer sentiment and product opportunity insights.\n\n### Deployment Geography for Use:\n\nGlobal; supported marketplace data is limited to the United States, Japan, and Germany.\n\n## Known Risks and Mitigations:\n\nRisk: The skill makes LinkFox/Jiimore network calls that can consume paid credits.\n\nMitigation: Confirm user intent before repeated calls, rely on the documented 24-hour parameter cache, and disclose additional cost before retries or expanded searches.\n\nRisk: The onboarding flow can involve phone/SMS login and payment steps.\n\nMitigation: Prefer the self-service LinkFox account page for key setup, avoid asking users to enter OTPs in chat where possible, and present payment actions for explicit user confirmation.\n\nRisk: API responses and session metadata are persisted locally.\n\nMitigation: Store results only in the documented workspace linkfox directory and remind users that saved review data and metadata may need cleanup under their local data-retention practices.\n\nRisk: Endpoint override environment variables can redirect requests to untrusted destinations.\n\nMitigation: Use the default LinkFox endpoints unless the user explicitly trusts and verifies any LINKFOX_* override destination.\n\n## Reference(s):\n\n- [Jiimore Niche Review API Reference](references/api.md)\n- [LinkFox Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub skill listing](https://clawhub.ai/linkfox-ai/skills/linkfox-jiimore-get-niche-review-from-keyword)\n- [LinkFox Skills](https://skill.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON, files, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON API responses or saved JSON response files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Full API responses are saved under a local linkfox session directory; large responses are summarized unless inline output is requested.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。 Skill: Jiimore-细分市场评论 Owner: linkfox-ai Summary: 亚马逊细分市场评论分析与消费者情感洞察。当用户提到细分市场评论分析、消费者情感、用户痛点、客户反馈洞察、评论主题分析、好评差评拆解、细分市场舆情挖掘、产品评论情感分析、niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Jiimore data时触发此技能。即使用户未明确提及\"细分市场评论\"，只要其需求涉及分析亚马逊细分市场中的消费者评论或理解细分市场层面的客户情感，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T05:20:00.058Z | u","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1315,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T00:57:47.370Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T00:57:47.370Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-14T16:36:48.303Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}