← 返回 Skills 市场
linkfox-ai

Echotik Product Search

作者 linkfox-ai · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
113
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install linkfox-echotik-product-search
功能描述
搜索和分析TikTok商品数据,包括销量、达人带货数据、定价和佣金比例,覆盖16个TikTok Shop站点。当用户提到TikTok商品搜索、TikTok Shop商品分析、TikTok销量数据、达人带货销售、TikTok选品、TikTok佣金比例、TikTok商品排名、EchoTik数据查询、TikTok pr...
使用说明 (SKILL.md)

EchoTik TikTok Product Search

This skill guides you on how to search and analyze TikTok Shop product data, helping sellers and marketers discover product opportunities, evaluate sales performance, and identify influencer-driven products on TikTok.

Core Concepts

EchoTik is a TikTok Shop analytics platform that tracks product performance across multiple TikTok marketplaces. This tool provides keyword-based product search with rich filtering capabilities, returning detailed product data including sales volumes (1d/7d/15d/30d/60d/90d/total), GMV (revenue), pricing, ratings, review counts, commission rates, and influencer promotion statistics.

Sales metrics: Products include multi-period sales data — 1-day, 7-day, 15-day, 30-day, 60-day, 90-day, and total sales. The same granularity applies to GMV (Gross Merchandise Value) amounts.

Commission rate: Stored as a decimal (e.g., 0.05 means 5%). When a user specifies a percentage, convert it to decimal before passing to the API.

Listing date: The firstCrawlDt field uses a compact integer format YYYYMMDD (e.g., 20240101 for January 1, 2024).

Parameter Guide

Search & Filtering

Parameter Type Description Default
keyword string Product keyword (translate to the local language of the target marketplace) -
region string Marketplace code US
categoryKeywordCN string Product category (must be in Chinese) -

Sales Filters

Parameter Type Description
minTotalSaleCnt / maxTotalSaleCnt integer Total sales volume range
minTotalSale30dCnt / maxTotalSale30dCnt integer 30-day sales volume range
minTotalSaleGmvAmt / maxTotalSaleGmvAmt string Total GMV range
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt string 30-day GMV range

Product Attribute Filters

Parameter Type Description
minSpuAvgPrice / maxSpuAvgPrice number SPU average price range
minProductRating / maxProductRating number Product rating range
minReviewCount / maxReviewCount integer Review count range
minProductCommissionRate / maxProductCommissionRate number Commission rate range (decimal, e.g., 0.05 = 5%)

Influencer & Video Filters

Parameter Type Description
minTotalIflCnt / maxTotalIflCnt integer Number of influencers promoting the product
minTotalVideoCnt / maxTotalVideoCnt integer Number of promotion videos
minTotalViewsCnt / maxTotalViewsCnt integer Total views on promotion videos

Listing Date & Duration

Parameter Type Description
minFirstCrawlDt / maxFirstCrawlDt integer Listing date range (YYYYMMDD format, e.g., 20240101)
saleDays integer Days since listing

Sorting & Pagination

Parameter Type Description Default
productSortField integer Sort field: 1=total sales, 2=total GMV, 3=avg price, 4=7d sales, 5=30d sales, 6=7d GMV, 7=30d GMV 1
sortType integer Sort order: 0=ascending, 1=descending 1
pageNum integer Page number 1
pageSize integer Results per page 50

Supported Marketplaces

US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)

Default marketplace is US. Use US when the user doesn't specify a marketplace.

API Usage

This tool calls the LinkFox tool gateway API. See references/api.md for calling conventions, request parameters, and response structure. You can also execute scripts/echotik_list_product.py directly to run queries.

Usage Examples

1. Basic Keyword Search — Find top-selling products for a keyword

{
  "keyword": "phone case",
  "region": "US",
  "productSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. High-Commission Product Discovery — Products with commission >= 10%

{
  "keyword": "beauty",
  "region": "US",
  "minProductCommissionRate": 0.10,
  "productSortField": 5,
  "sortType": 1
}

3. New & Trending Products — Recently listed with strong 30-day sales

{
  "keyword": "gadget",
  "region": "US",
  "minFirstCrawlDt": 20250101,
  "minTotalSale30dCnt": 1000,
  "productSortField": 5,
  "sortType": 1
}

4. Influencer-Hot Products — Products promoted by many influencers

{
  "keyword": "skincare",
  "region": "US",
  "minTotalIflCnt": 50,
  "minTotalViewsCnt": 1000000,
  "productSortField": 1,
  "sortType": 1
}

5. Budget-Friendly High-Sellers — Low price + high volume

{
  "keyword": "accessories",
  "region": "US",
  "maxSpuAvgPrice": 10,
  "minTotalSaleCnt": 5000,
  "productSortField": 2,
  "sortType": 1
}

6. Southeast Asia Market Exploration

{
  "keyword": "fashion",
  "region": "TH",
  "minTotalSale30dCnt": 500,
  "productSortField": 7,
  "sortType": 1
}

Display Rules

  1. Present data clearly: Show query results in organized tables with key columns — product name, price, total sales, 30-day sales, GMV, rating, commission rate, and number of promoting influencers
  2. Currency awareness: Include the currency field from the response when displaying prices and GMV
  3. Commission formatting: Display commission rates as percentages for readability (e.g., show 0.05 as "5%")
  4. Volume notice: When results have a large total count, show the current page data and inform the user of total available records; suggest adjusting filters or pagination to explore more
  5. Image reference: If imageUrl or coverUrl is present, mention it so the user knows product images are available
  6. Error handling: When a query fails, explain the reason based on the response and suggest adjusting parameters
  7. Keyword translation reminder: When the user targets a non-English marketplace, remind them that the keyword should be in the local language of that marketplace for best results

Applicable Scenarios

User Says Scenario
"Find trending products on TikTok" Keyword search sorted by sales
"TikTok products with high commission" Filter by commission rate
"What's selling well on TikTok Shop US" Regional product search by sales
"New products blowing up on TikTok" Filter by listing date + sales
"Which products have many influencers promoting them" Filter by influencer count
"Cheap but high-volume TikTok products" Filter by price + sales
"TikTok product research for Southeast Asia" Search specific SE Asian regions
"Products with good reviews on TikTok" Filter by rating + review count

Not Applicable Scenarios

  • TikTok influencer/creator analytics (follower counts, engagement rates of creators)
  • TikTok video performance analytics (views, likes, shares on specific videos)
  • TikTok advertising / ad campaign management
  • Amazon, Shopee, or other non-TikTok platform product data
  • TikTok Shop store-level analytics
  • Product listing creation or optimization advice
  • Logistics, fulfillment, or shipping analysis

Boundary judgment: When users say "product research" or "what should I sell on TikTok", if it involves searching and filtering products by sales data, pricing, or commission rates on TikTok Shop, then this skill applies. If they're asking about content strategy, video creation, or influencer outreach, it does not apply.

Feedback:

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

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

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


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

安全使用建议
Key things to check before installing: - The skill's code and docs require an environment variable LINKFOXAGENT_API_KEY (used as Authorization) but the registry metadata does not declare this — expect to need that API key. Confirm where that key comes from and whether you trust the provider. - The skill calls https://tool-gateway.linkfox.com (primary data flow) and references a Feishu wiki URL for obtaining the key (yxgb3sicy7.feishu.cn). Verify both endpoints and the publisher identity before providing credentials. - Because the skill can be invoked autonomously, do not supply long-lived or highly privileged credentials unless you trust the service. Prefer scoped/ephemeral keys and monitor usage. - The skill is designed to auto-trigger on many phrases (including vague ones), which may cause unexpected activations. If you want tighter control, avoid enabling autonomous invocation or restrict triggers. - If you need to proceed, request the publisher to update the registry metadata to explicitly list LINKFOXAGENT_API_KEY as a required environment variable and to provide clear documentation about what permissions that key grants and where it is stored or logged.
功能分析
Type: OpenClaw Skill Name: linkfox-echotik-product-search Version: 1.0.3 The skill is a legitimate tool for searching and analyzing TikTok Shop product data via the EchoTik platform. The Python script (echotik_list_product.py) uses standard libraries to communicate with a documented API endpoint (tool-gateway.linkfox.com) and securely retrieves its API key from environment variables. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found in the code or instructions.
能力评估
Purpose & Capability
Name, description, API endpoint (tool-gateway.linkfox.com), examples, and included script all align with a TikTok Shop product-search capability. The included Python script calls the listed API and the reference doc documents the same parameters and response fields.
Instruction Scope
SKILL.md instructs the agent to call the LinkFox tool gateway API and/or run the provided script with JSON parameters — that stays within the stated purpose. One design choice to note: the skill should auto-trigger for a broad set of phrases (including cases where 'TikTok' isn't explicitly mentioned), which may cause over-triggering in ambiguous conversations.
Install Mechanism
There is no install spec (instruction-only behavior) and the included script is standalone Python that requires no installation. This is low-risk compared to remote download/install flows.
Credentials
The skill's runtime files (scripts/echotik_list_product.py) and references clearly require an API key from the environment variable LINKFOXAGENT_API_KEY, but the registry metadata lists no required environment variables or primary credential. The skill will fail without that key, and the missing declaration is an incoherence that could hide credential requirements from users. The API key is sent in an Authorization header to https://tool-gateway.linkfox.com; no other credentials are requested.
Persistence & Privilege
always:false and there's no install-time persistent modification. The skill can be invoked autonomously (disable-model-invocation:false) which is platform default; this increases blast radius if you supply credentials, but by itself is not an unusual setting.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install linkfox-echotik-product-search
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /linkfox-echotik-product-search 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.3
- Expanded trigger description to cover more TikTok-related product research phrases, including English keywords like "TikTok product search," "TikTok sales," "short-video e-commerce," etc. - Skill is now triggered by a wider range of keywords, not just explicit mentions of TikTok or EchoTik. - No changes to functionality or API usage.
v1.0.2
No user-facing changes in this version. - No file changes detected; functionality and behavior remain the same. - Documentation, parameters, usage, and display rules are unchanged.
v1.0.1
- Expanded and clarified skill triggers to activate on TikTok product research/analytics queries, even if not directly mentioning "EchoTik" or "TikTok". - Greatly enriched documentation: detailed parameter descriptions, filtering options, and marketplace support now included. - Added clear usage examples for varied scenarios (e.g., high-commission, influencer-driven, region-specific searches). - Updated display guidelines for presenting results, handling errors, and advising on keyword language for non-English regions. - Revised applicable and not applicable use cases for better user guidance.
元数据
Slug linkfox-echotik-product-search
版本 1.0.3
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Echotik Product Search 是什么?

搜索和分析TikTok商品数据,包括销量、达人带货数据、定价和佣金比例,覆盖16个TikTok Shop站点。当用户提到TikTok商品搜索、TikTok Shop商品分析、TikTok销量数据、达人带货销售、TikTok选品、TikTok佣金比例、TikTok商品排名、EchoTik数据查询、TikTok pr... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 113 次。

如何安装 Echotik Product Search?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install linkfox-echotik-product-search」即可一键安装,无需额外配置。

Echotik Product Search 是免费的吗?

是的,Echotik Product Search 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Echotik Product Search 支持哪些平台?

Echotik Product Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Echotik Product Search?

由 linkfox-ai(@linkfox-ai)开发并维护,当前版本 v1.0.3。

💬 留言讨论