← Back to Skills Marketplace
linkfox-ai

Echotik New Product Rank

by linkfox-ai · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
101
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install linkfox-echotik-new-product-rank
Description
通过EchoTik新品排行数据,发现TikTok Shop 16个区域市场的热门新品。当用户提到TikTok新品排行、TikTok热销商品、TikTok Shop爆品、短视频电商选品、TikTok新品发掘、跨境TikTok选品、TikTok new product rankings, TikTok bestsel...
README (SKILL.md)

EchoTik - TikTok New Product Ranking

This skill guides you on how to query and analyze the TikTok Shop new product ranking data via the EchoTik data source, helping cross-border e-commerce sellers identify trending new products across TikTok's regional markets.

Core Concepts

The TikTok New Product Ranking tracks recently listed products that are gaining traction on TikTok Shop. It reveals which new products are selling well, their pricing, sales volume, influencer coverage, and live-stream activity. This is an essential tool for product scouting, trend analysis, and competitive intelligence in the short-video e-commerce space.

Data scope: The ranking covers 16 TikTok Shop markets and provides daily snapshots of new products along with their performance metrics (sales volume, revenue, influencer count, video count, live-stream count, commission rate, ratings, and more).

Pagination: Results are paginated. Use pageNum (page number, starting from 1) and pageSize (items per page, default 50) to navigate through the result set.

Parameter Guide

Parameter Type Required Description
date string Yes Query date in YYYY-MM-DD format
region string No Market region code. Default: US. See Supported Markets below
pageNum integer No Page number, starting from 1 (default: 1)
pageSize integer No Number of products per page (default: 50)

Supported Markets

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

Default market is US. Use US when the user does not specify a market.

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_new_product_rank.py directly to run queries.

Usage Examples

1. Today's trending new products in the US Query the US market for the current date to see which new products are gaining traction.

date: "2025-06-15", region: "US"

2. Discover hot new products in Southeast Asia Check the Indonesian or Thai market for new product opportunities.

date: "2025-06-15", region: "ID"

3. Browse the UK market new product ranking Scout the UK TikTok Shop for trending new arrivals.

date: "2025-06-15", region: "GB"

4. Paginate through a large result set Retrieve the second page of 20 results for the US market.

date: "2025-06-15", region: "US", pageNum: 2, pageSize: 20

Data Fields (Response)

Field API Name Description
Product Title title Name of the product
Product ID asin Unique product identifier
Region region Market region code
Price (Avg) price Average SPU price
Min Price minPrice Lowest price
Max Price maxPrice Highest price
Currency currency Currency code
Total Sales totalSaleCnt Total units sold
30-Day Sales totalSale30dCnt Units sold in the last 30 days
Total Revenue totalSaleGmvAmt Total gross merchandise value
30-Day Revenue totalSaleGmv30dAmt Revenue in the last 30 days
Sales Trend salesTrendFlagText Sales trend indicator (0 = stable, 1 = rising, 2 = declining)
Total Videos totalVideoCnt Number of associated videos
Total Live Streams totalLiveCnt Number of associated live streams
Total Influencers totalIflCnt Number of influencers promoting the product
Commission Rate productCommissionRate Product commission rate
Rating productRating Average product rating
Review Count reviewCount Number of product reviews
First Seen Date availableDate Date the product was first tracked
Category ID categoryId Product category identifier
Image URL imageUrl Product image URL
Image URLs productImageUrls List of product image URLs

Display Rules

  1. Present data only: Show query results in clear tables without subjective business advice
  2. Sales trend clarification: When showing sales trend data, translate the numeric flag into human-readable labels: 0 = Stable, 1 = Rising, 2 = Declining
  3. Currency awareness: Always display prices alongside their currency code since different markets use different currencies
  4. Volume notice: When results are large, show a summary of the top products and remind users they can paginate for more results
  5. Image handling: If product image URLs are available, mention them but do not attempt to render images inline unless the environment supports it
  6. Error handling: When a query fails, explain the reason and suggest adjusting the date or region parameters

Important Limitations

  • Date required: The date parameter is mandatory; there is no default date
  • Daily granularity: Data is a daily snapshot, not weekly or monthly
  • Pagination: Use pageNum and pageSize to navigate large result sets; not all products are returned in a single call

User Expression & Scenario Quick Reference

Applicable -- TikTok Shop new product discovery and trend analysis:

User Says Scenario
"What new products are trending on TikTok" New product ranking lookup
"TikTok bestsellers today", "hot products on TikTok Shop" Daily ranking query
"New product opportunities in Southeast Asia TikTok" Regional market scouting
"Which new items are selling well on TikTok UK" Region-specific ranking
"TikTok product scouting", "short-video e-commerce trends" General product discovery
"Show me rising new products on TikTok" Trend-filtered ranking
"TikTok influencer product picks", "what are TikTok creators promoting" Influencer-driven product discovery

Not applicable -- Needs beyond TikTok new product rankings:

  • Amazon product research or ABA keyword data
  • TikTok advertising / ad campaign management
  • TikTok content creation or video editing
  • Product reviews or listing copywriting
  • Historical trend analysis spanning many months (this tool provides daily snapshots)
  • Profit margin calculations or pricing strategy

Boundary judgment: When users say "product research" or "what's selling well", if the context clearly involves TikTok Shop or short-video e-commerce, this skill applies. If they are asking about Amazon, Shopify, or other platforms, 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.

Usage Guidance
This skill appears to be a straightforward API client for EchoTik/LinkFox, but the included Python script expects an environment variable LINKFOXAGENT_API_KEY even though the registry metadata lists no required credentials. Before installing: (1) confirm the provider (tool-gateway.linkfox.com and skill-api.linkfox.com) are legitimate for your use; (2) ask the publisher or registry why LINKFOXAGENT_API_KEY is not declared and request an updated metadata entry that documents the required API key; (3) only provide a dedicated, least-privilege API key (not high-privilege or unrelated service credentials) and store it securely; (4) consider testing the skill in an isolated environment and monitor network requests to verify only expected data (date/region/page) are sent; (5) if you need stronger assurances, request provenance for the Feishu authorization link and confirm the key's intended scope and expiry/rotation policy.
Capability Analysis
Type: OpenClaw Skill Name: linkfox-echotik-new-product-rank Version: 1.0.1 The skill is designed to query TikTok Shop new product rankings via the EchoTik data source using a LinkFox API gateway. The Python script `scripts/echotik_list_new_product_rank.py` performs standard authenticated POST requests to `tool-gateway.linkfox.com` using an environment variable for the API key. The instructions in `SKILL.md` and the API documentation in `references/api.md` are consistent with the stated purpose and do not contain any malicious directives or evidence of data exfiltration.
Capability Assessment
Purpose & Capability
The skill's purpose (query EchoTik new-product rankings) matches the included code and docs, but the registry metadata lists no required credentials while the script and API docs clearly require an API key (LINKFOXAGENT_API_KEY). That missing declaration is an incoherence between what the skill claims and what it actually needs.
Instruction Scope
SKILL.md and references/api.md confine runtime actions to calling the LinkFox tool-gateway API and optionally the Feedback API. Instructions do not request unrelated files, host system data, or broad context collection. However, the runtime guidance expects an environment-stored API key (documented in the script/docs) even though the registry metadata omitted it.
Install Mechanism
There is no install spec or remote download; the package contains a small Python script and docs. No archives or external installers are fetched, so install-time risk is low.
Credentials
The script requires a single API credential (LINKFOXAGENT_API_KEY) to authenticate requests to https://tool-gateway.linkfox.com, which is proportionate for an API caller. The problem is the skill registry declares no required env vars or primary credential — the absent declaration is a red flag because users won't be informed the skill needs a secret and where it will be used.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system settings, and has normal autonomous-invocation defaults. No elevated or permanent privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install linkfox-echotik-new-product-rank
  3. After installation, invoke the skill by name or use /linkfox-echotik-new-product-rank
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Initial public release of linkfox-echotik-new-product-rank. - Provides daily TikTok Shop new product rankings from EchoTik across 16 regional markets. - Supports keyword-triggered discovery for trending, bestselling, and viral new products on TikTok Shop. - Includes parameter guide, supported markets, API usage instructions, and response data fields. - Outlines clear display rules, limitations, and user intent boundaries for appropriate trigger scenarios. - Integrated automatic feedback reporting for user experience improvements.
Metadata
Slug linkfox-echotik-new-product-rank
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Echotik New Product Rank?

通过EchoTik新品排行数据,发现TikTok Shop 16个区域市场的热门新品。当用户提到TikTok新品排行、TikTok热销商品、TikTok Shop爆品、短视频电商选品、TikTok新品发掘、跨境TikTok选品、TikTok new product rankings, TikTok bestsel... It is an AI Agent Skill for Claude Code / OpenClaw, with 101 downloads so far.

How do I install Echotik New Product Rank?

Run "/install linkfox-echotik-new-product-rank" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Echotik New Product Rank free?

Yes, Echotik New Product Rank is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Echotik New Product Rank support?

Echotik New Product Rank is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Echotik New Product Rank?

It is built and maintained by linkfox-ai (@linkfox-ai); the current version is v1.0.1.

💬 Comments