Agent skill

Linkfox Tiktok Shop Product Detail

by linkfox-ai in linkfox-ai/linkfox-skills

查询 TikTok Shop 公共商品详情。输入完整商品 URL 或 19 位商品 ID,可指定美国、英国、东南亚及欧洲主要站点,返回商品标题、类目、价格、销量、SKU 库存、图片、店铺、评论概况、物流与促销等分组数据。当用户提到 TikTok Shop 商品详情、TikTok 商品链接解析、商品 ID 查询、价格库存核对、SKU 变体、竞品页面拆解、TikTok product…

MITAuto-check passed

Install Linkfox Tiktok Shop Product Detail

skills CLI
$ npx skills add linkfox-ai/linkfox-skills --skill linkfox-tiktok-shop-product-detail -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install linkfox-ai/linkfox-skills linkfox-tiktok-shop-product-detail --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/linkfox-ai/linkfox-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/linkfox-tiktok-shop-product-detail .claude/skills/linkfox-tiktok-shop-product-detail && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
linkfox-tiktok-shop-product-detail
GitHub stars
107
Token cost
~1.6k tokens
SKILL.md length
708 words
Files
5 (incl. scripts, references)
Skills in repo
177
Repo updated
First seen
Licence
MIT

At a glance

查询 TikTok Shop 公共商品详情。输入完整商品 URL 或 19 位商品 ID,可指定美国、英国、东南亚及欧洲主要站点,返回商品标题、类目、价格、销量、SKU 库存、图片、店铺、评论概况、物流与促销等分组数据。当用户提到 TikTok Shop 商品详情、TikTok 商品链接解析、商品 ID 查询、价格库存核对、SKU 变体、竞品页面拆解、TikTok product…

  • Works in 8 steps: Lead with the product title, product ID,… → Show sale/original price with the… → Present SKU variants, variant prices,… → …
  • SKILL.md covers Core Concepts, Data Fields, Parameter Guide and 调用方式, plus 6 more sections
  • Runs Python scripts from its folder; calls python; reaches shop.tiktok.com; needs LINKFOX_AGENT_API_KEY and LINKFOXAGENT_API_KEY

What it does

Linkfox Tiktok Shop Product Detail is an agent skill from linkfox-ai/linkfox-skills. 查询 TikTok Shop 公共商品详情。输入完整商品 URL 或 19 位商品 ID,可指定美国、英国、东南亚及欧洲主要站点,返回商品标题、类目、价格、销量、SKU 库存、图片、店铺、评论概况、物流与促销等分组数据。当用户提到 TikTok Shop 商品详情、TikTok 商品链接解析、商品 ID 查询、价格库存核对、SKU 变体、竞品页面拆解、TikTok product details、TikTok Shop listing lookup 时触发。即使用户未明确说“商品详情”,只要希望根据一个 TikTok Shop 商品 URL 或 19 位商品 ID 读取当前公开商品页数据,也应触发此技能。

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/api.md`, `references/onboarding.md` and `scripts/onboarding.py`).

It works with TikTok. The licence is MIT.

Example prompts

  • “/linkfox-tiktok-shop-product-detail”

Requirements

  • Python 3
  • A credential in LINKFOX_AGENT_API_KEY
  • A credential in LINKFOXAGENT_API_KEY

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Lead with the product title, product ID, requested region, category, and returned status.
  2. Show sale/original price with the returned currency; never convert currencies unless the user asks separately.
  3. Present SKU variants, variant prices, and stock in a table when available.
  4. Render product images inline when useful, but avoid flooding the response with every image.
  5. Show seller, public sold count, review summary, and shipping information only when present.
  6. Treat status, stock, and purchase-button data together; do not call a product “available” from one field alone.
  7. Report missing, empty, or inconsistent fields as unavailable rather than estimating them.
  8. For large nested sections, summarize first and read exact fields from the saved JSON only as needed.

What it can do on your machine

Read from SKILL.md and the folder at commit 38fef04. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • shop.tiktok.com

    Also links to:

    • skill.linkfox.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • LINKFOX_AGENT_API_KEY
    • LINKFOXAGENT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Linkfox Tiktok Shop Product Detail loads about 1.6k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 708 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from linkfox-ai/linkfox-skills at commit 38fef04, republished under its MIT licence (© linkfox-ai). 708 words, ~1,625 tokens.

Download SKILL.mdSave it as .claude/skills/linkfox-tiktok-shop-product-detail/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
linkfox-tiktok-shop-product-detail
description
查询 TikTok Shop 公共商品详情。输入完整商品 URL 或 19 位商品 ID,可指定美国、英国、东南亚及欧洲主要站点,返回商品标题、类目、价格、销量、SKU 库存、图片、店铺、评论概况、物流与促销等分组数据。当用户提到 TikTok Shop 商品详情、TikTok 商品链接解析、商品 ID 查询、价格库存核对、SKU 变体、竞品页面拆解、TikTok product details、TikTok Shop listing lookup 时触发。即使用户未明确说“商品详情”,只要希望根据一个 TikTok Shop 商品 URL 或 19 位商品 ID 读取当前公开商品页数据,也应触发此技能。

TikTok Shop Product Detail Lookup

Fetch the current public detail of one TikTok Shop product by product URL or 19-digit product ID, with an optional marketplace region.

Core Concepts

  • One product per call: productInput identifies one product; this is not a search or ranking tool.
  • Marketplace context: region selects the storefront context and defaults to US.
  • Readable grouped data: the service returns a stable, readable set of product-detail groups.
  • Current snapshot: values reflect what the public storefront exposes at request time, not historical analytics.

Data Fields

Each object in data may contain these top-level groups:

FieldDescription
productIdTikTok Shop product ID
statusPlatform product status code; do not infer availability from this field alone
titleProduct title
categoryCategory name and ID
pricingCurrency, sale price, original price, discount, and source pricing fields
salesPublic sold count and related sales display data
inventoryTotal stock, SKUs, variant properties, prices, and default selection
mediaProduct image URLs and image metadata
sellerSeller ID, shop name, rating, location, and available shop data
reviewsPublic review summary when available
shippingLogistics and shipping modules when available
actionsPurchase-button and favorite-state data
additionalOther readable promotion, rights, review-entry, and product modules

Nested fields vary by product and region. Preserve the returned values rather than inventing missing fields.

Parameter Guide

ParameterRequiredDefaultDescription
productInputYes-TikTok HTTPS URL on tiktok.com or a subdomain, using the default HTTPS port and a path containing product/<19-digit-id>; or a 19-digit product ID passed as a string
regionNoUSUppercase storefront code: US, GB, ID, MY, TH, VN, PH, SG, DE, FR, IT, or ES

调用方式

  • API 端点:POST /tiktok/shop/product/detail(完整参数/响应/错误码见 references/api.md)
  • Python 脚本:python scripts/tiktok_shop_product_detail.py '<JSON 参数>' [--inline]
  • 成本约束:本工具会消耗算力;同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。

输出策略(脚本默认行为):

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-tiktok-shop-product-detail-<timestamp>.json(<cwd> 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;<session> 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)
  • 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)
  • 加 --inline 强制全量打印到 stdout(同样落盘)

读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

异常情况
  • 未配置 API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY。
  • 响应 401 或 402 状态码。
  • 响应提示算力或余额不足:消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义。

Usage Examples

Product URL

bash
python scripts/tiktok_shop_product_detail.py '{"productInput":"https://shop.tiktok.com/view/product/1729937400435937604","region":"US"}'

Product ID for the UK storefront

bash
python scripts/tiktok_shop_product_detail.py '{"productInput":"1729937400435937604","region":"GB"}'

Display Rules

  1. Lead with the product title, product ID, requested region, category, and returned status.
  2. Show sale/original price with the returned currency; never convert currencies unless the user asks separately.
  3. Present SKU variants, variant prices, and stock in a table when available.
  4. Render product images inline when useful, but avoid flooding the response with every image.
  5. Show seller, public sold count, review summary, and shipping information only when present.
  6. Treat status, stock, and purchase-button data together; do not call a product “available” from one field alone.
  7. Report missing, empty, or inconsistent fields as unavailable rather than estimating them.
  8. For large nested sections, summarize first and read exact fields from the saved JSON only as needed.
Show full SKILL.md (239 more words)Show less

Important Limitations

  1. Public fields can vary by product, seller, region, and storefront context.
  2. URL inputs must include a product/<19-digit-id> path segment; use the 19-digit product ID directly when another TikTok URL format is unavailable.
  3. A product may be removed, unavailable, or out of stock and still return structured metadata.
  4. This tool does not provide historical price/stock trends, ranking lists, or guaranteed sales analytics.
  5. This tool does not manage an authorized seller account or edit listings; use the TikTok Shop ERP product skill for seller operations.
  6. The readable response can be large because SKU, media, shipping, and additional modules retain nested source fields.

User Expression & Scenario Quick Reference

Applicable — one known TikTok Shop product:

User SaysScenario
“查这个 TikTok Shop 链接的商品详情”URL detail lookup
“这个 19 位 TikTok 商品 ID 卖什么?”Product ID lookup
“看看这个商品的价格、SKU 和库存”Current listing audit
“提取这个 TikTok 商品的图片和店铺信息”Media and seller extraction

Not applicable:

  • TikTok product search, bestseller rankings, or multi-product screening
  • Historical GMV, creator, livestream, or video-attribution analytics
  • Authorized shop listing creation, editing, price changes, or stock changes
  • TikTok video-page or creator-profile analysis

算力消耗规则

消耗 63 算力。

用户会因算力消耗而支付费用。重复查询不同地区或不同商品会分别计费;继续调用前应让用户知晓额外消耗。

Feedback:

Auto-detect and report feedback via the Feedback API when the described capability differs from actual behavior, results miss the user's intent, the user expresses praise or dissatisfaction, or the skill can be improved. Follow references/api.md without interrupting the user's flow.


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

© linkfox-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/linkfox-tiktok-shop-product-detail of linkfox-ai/linkfox-skills.

  • SKILL.md
  • references/api.md
  • references/onboarding.md
  • scripts/onboarding.py
  • scripts/tiktok_shop_product_detail.py

Open the folder on GitHubat commit 38fef04

Compare with similar skills

Linkfox Tiktok Shop Product Detail next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linkfox Tiktok Shop Product Detail compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linkfox Tiktok Shop Product Detail this skilllinkfox-ai/linkfox-skills107—~1.6kAutomated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone
Video Transcribewendy7756/AI-Video-Transcriber3.3k—~937Automated safety check: NotesApache-2.0
Last30days CnJesseovo/last30days-skill-cn1.9k—~2.4kAutomated safety check: NotesMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • Video Transcribe

    wendy7756/AI-Video-Transcriber

    Transcribe and summarize a video or podcast from a URL (YouTube, TikTok, Bilibili, Apple Podcasts, SoundCloud, 30+ platforms) or from a local media/.txt file.

    3.3k GitHub stars~937 tokensUpdated 26 days ago
    Media & CreativeAuto-check: notes
  • Last30days Cn

    Jesseovo/last30days-skill-cn

    Research what Chinese internet users actually said in the last 30 days across Weibo, Xiaohongshu (RED), Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu and Toutiao: engagement-weighted…

    1.9k GitHub stars~2.4k tokensUpdated 4 days ago
    Productivity & AutomationAuto-check: notes
  • Postiz

    gitroomhq/postiz-agent

    Postiz is a tool to schedule social media and chat posts to 28+ channels X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest…

    508 GitHub starsUsed in 2 repos~7.9k tokens
    Writing & ContentAuto-check passed

More from linkfox-ai/linkfox-skills

All 177 skills in this repo
  • Linkfox 1688 Search By Image

    linkfox-ai/linkfox-skills

    1688平台以图搜图,通过商品图片精准检索外观相似或同款的1688货源,返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by…

    107 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Linkfox Aba Intelligent Query

    linkfox-ai/linkfox-skills

    亚马逊ABA(品牌分析)搜索词数据的查询与分析,涵盖15个站点近3年的周维度数据。当用户提到ABA数据、亚马逊搜索词分析、关键词挖掘、搜索排名趋势、市场机会分析、季节性关键词、高点击低转化分析、蓝海词发现、竞品关键词分析、ABA data, search term report, keyword mining, search ranking trends, blue ocean…

    107 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Linkfox Amazon Alexa Search

    linkfox-ai/linkfox-skills

    通过亚马逊前台的 Alexa 购物助手发起自然语言问答,获取与问题相关的导购回答、推荐商品分组、ASIN 列表,以及可继续追问的问题。每次调用仅支持 1 条 prompt,如需追问须由 agent 总结上下文后拼接新问题发起新请求。可用 url 补充亚马逊页面上下文。当用户提到亚马逊 Alexa、Alexa 购物助手、亚马逊智能助手、AI…

    107 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • 亚马逊反向选品:基于历史商业洞察报告沉淀的指标数据池,按 30+ 项商业维度(市场规模与增长、价格区间与档位份额、竞争密度与头部集中度、人群画像如年龄/性别/收入、评论卖点与痛点等)反向筛选亚马逊赛道与关键词。当用户提到反向选品、指标筛选、细分市场反查、蓝海赛道挖掘、低竞争赛道、新人友好赛道、品牌分散市场、痛点切入、卖点反查、定价档位机会、人群画像选品、Amazon niche reverse…

    107 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Linkfox Amazon Product Detail

    linkfox-ai/linkfox-skills

    通过ASIN获取亚马逊商品详细信息,包括标题、图片、五点描述、规格参数、A+页面、价格、评分评论、变体等;可在取得原始HTML时尝试提取Item Highlights(商品亮点)。当用户提到亚马逊商品详情、ASIN查询、商品页面数据、Listing分析、五点描述提取、Item…

    107 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Linkfox Amazon Reviews List

    linkfox-ai/linkfox-skills

    按ASIN获取并分析亚马逊商品评论,支持15个站点(含美国站),按星级筛选评论。当用户提到亚马逊评论、美国站评论、商品评价、买家投诉、差评、好评、星级评分、评论分析、评论情感、产品改良建议、Vine评论、已验证购买评论、竞品评论研究、Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review…

    107 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed

Works with

Questions about Linkfox Tiktok Shop Product Detail

What does Linkfox Tiktok Shop Product Detail do?

查询 TikTok Shop 公共商品详情。输入完整商品 URL 或 19 位商品 ID,可指定美国、英国、东南亚及欧洲主要站点,返回商品标题、类目、价格、销量、SKU 库存、图片、店铺、评论概况、物流与促销等分组数据。当用户提到 TikTok Shop 商品详情、TikTok 商品链接解析、商品 ID 查询、价格库存核对、SKU 变体、竞品页面拆解、TikTok product…. Linkfox Tiktok Shop Product Detail is an agent skill from linkfox-ai/linkfox-skills.

How do I install Linkfox Tiktok Shop Product Detail in Claude Code?

Run `npx skills add linkfox-ai/linkfox-skills --skill linkfox-tiktok-shop-product-detail -a claude-code`. Or copy the skill folder (skills/linkfox-tiktok-shop-product-detail in linkfox-ai/linkfox-skills) into .claude/skills/linkfox-tiktok-shop-product-detail in your project. Claude Code loads it when a task matches its description.

How do I install Linkfox Tiktok Shop Product Detail in Codex?

Run `npx skills add linkfox-ai/linkfox-skills --skill linkfox-tiktok-shop-product-detail -a codex`. Or copy the skill folder (skills/linkfox-tiktok-shop-product-detail in linkfox-ai/linkfox-skills) into .agents/skills/linkfox-tiktok-shop-product-detail in your project. Codex loads it when a task matches its description.

Can I use Linkfox Tiktok Shop Product Detail in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add linkfox-ai/linkfox-skills --skill linkfox-tiktok-shop-product-detail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linkfox-tiktok-shop-product-detail, .gemini/skills/linkfox-tiktok-shop-product-detail, .github/skills/linkfox-tiktok-shop-product-detail and .opencode/skills/linkfox-tiktok-shop-product-detail in your project.

What does Linkfox Tiktok Shop Product Detail need to run?

Going by SKILL.md and its folder, Linkfox Tiktok Shop Product Detail needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named LINKFOX_AGENT_API_KEY and LINKFOXAGENT_API_KEY. Our summary lists: Python 3; A credential in LINKFOX_AGENT_API_KEY; A credential in LINKFOXAGENT_API_KEY.

Does Linkfox Tiktok Shop Product Detail access the network?

SKILL.md names 2 domains. In commands or code: shop.tiktok.com; the agent is likely to contact it when it follows the instructions. As links in the text: skill.linkfox.com. This is read from the text; nothing was executed.

Is Linkfox Tiktok Shop Product Detail safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linkfox Tiktok Shop Product Detail use?

Linkfox Tiktok Shop Product Detail is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linkfox Tiktok Shop Product Detail use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Linkfox Tiktok Shop Product Detail?

Skills that share tags, products or a category with Linkfox Tiktok Shop Product Detail: Social (coreyhaines31/marketingskills, 54k stars), Last30days (mvanhorn/last30days-skill, 64k stars), Social Content (freekmurze/dotfiles, 1k stars) and Video Transcribe (wendy7756/AI-Video-Transcriber, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linkfox Tiktok Shop Product Detail?

linkfox-ai (a GitHub user) maintains it in linkfox-ai/linkfox-skills, which has 107 GitHub stars. The repository holds 177 skills in this directory. The repository was last updated on September 14, 2026.

Source: linkfox-ai/linkfox-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.