Agent skill

Linkfox Amazon Store Catalog

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

亚马逊商品目录(Catalog Items)查询。用于按 ASIN 获取目录详情,按关键词、标识符或分类条件搜索商品,以及查询商品类目节点、标题摘要、图片和其他 includedData。用户提到亚马逊商品目录、Catalog Items、ASIN…

MITAuto-check passed

Install Linkfox Amazon Store Catalog

skills CLI
$ npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-store-catalog -a claude-code

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

GitHub CLI
$ gh skill install linkfox-ai/linkfox-skills linkfox-amazon-store-catalog --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-amazon-store-catalog .claude/skills/linkfox-amazon-store-catalog && 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-amazon-store-catalog
GitHub stars
107
Token cost
~1.3k tokens
SKILL.md length
284 words
Files
9 (incl. scripts, references)
Skills in repo
177
Repo updated
First seen
Licence
MIT

At a glance

亚马逊商品目录(Catalog Items)查询。用于按 ASIN 获取目录详情,按关键词、标识符或分类条件搜索商品,以及查询商品类目节点、标题摘要、图片和其他 includedData。用户提到亚马逊商品目录、Catalog Items、ASIN…

  • Works in 2 steps: 依赖 linkfox-amazon-store-auth;python… → 应用需具备 Catalog Items…
  • SKILL.md covers 调用方式, 解决认证和算力问题, 官方参考索引 and Prerequisites, plus 7 more sections
  • Runs Python scripts from its folder; calls python; needs LINKFOXAGENT_API_KEY and LINKFOX_AGENT_API_KEY

What it does

Linkfox Amazon Store Catalog is an agent skill from linkfox-ai/linkfox-skills. 亚马逊商品目录(Catalog Items)查询。用于按 ASIN 获取目录详情,按关键词、标识符或分类条件搜索商品,以及查询商品类目节点、标题摘要、图片和其他 includedData。用户提到亚马逊商品目录、Catalog Items、ASIN 查商品、关键词搜亚马逊商品、类目节点、商品图片或摘要、searchCatalogItems、getCatalogItem、listCatalogCategories 时触发。即使未明确说“Catalog”,只要希望查询亚马逊全站目录中的商品基础资料而不是卖家自己的 Listing,也应触发此技能;卖家 SKU 的刊登增删改查使用 linkfox-amazon-store-listings。

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

It works with Python. The licence is MIT.

Example prompts

  • “Catalog”
  • “/linkfox-amazon-store-catalog”

Requirements

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

Workflow steps

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

  1. 依赖 linkfox-amazon-store-auth;python scripts/check_auth_dependency.py,exit 42 时需先安装授权 skill。
  2. 应用需具备 Catalog Items 相关角色;searchCatalogItems 按 identifiers+SKU 检索时 query 须带 sellerId(脚本在 identifiersType=SKU 时自动使用入参 sellerId)。

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 6 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

    Links to these hosts (documentation or services it may open):

    • developer-docs.amazon.com
    • 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:

    • LINKFOXAGENT_API_KEY
    • LINKFOX_AGENT_API_KEY

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

Context cost

Linkfox Amazon Store Catalog loads about 1.3k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 88 tokens; SKILL.md has 284 words of instructions outside code blocks.

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

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). 284 words, ~1,314 tokens.

Download SKILL.mdSave it as .claude/skills/linkfox-amazon-store-catalog/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
linkfox-amazon-store-catalog
description
亚马逊商品目录(Catalog Items)查询。用于按 ASIN 获取目录详情,按关键词、标识符或分类条件搜索商品,以及查询商品类目节点、标题摘要、图片和其他 includedData。用户提到亚马逊商品目录、Catalog Items、ASIN 查商品、关键词搜亚马逊商品、类目节点、商品图片或摘要、searchCatalogItems、getCatalogItem、listCatalogCategories 时触发。即使未明确说“Catalog”,只要希望查询亚马逊全站目录中的商品基础资料而不是卖家自己的 Listing,也应触发此技能;卖家 SKU 的刊登增删改查使用 linkfox-amazon-store-listings。

Amazon 店铺 Catalog Items

本 skill 与 linkfox-amazon-store-auth 等同属 Amazon Store 系列:依赖 linkfox-amazon-store-auth 选店(sellerId+region);直接 POST /spApi/developerProxy 传入 sellerId+region,由服务端解析 token(勿传 amzAccessToken,除非兼容旧调用)。转发 GET。

调用方式

  • API 端点:POST /spApi/developerProxy(不同操作通过请求体区分;完整参数/响应/错误码见 references/api.md)
  • Python 脚本:python scripts/<脚本名>.py '<JSON 参数>' [--inline](可用脚本见上文脚本一览)
  • 成本约束:本工具会消耗算力;失败/空结果不得自动换关键词、翻页或连续试探;需要继续检索时先向用户说明会产生额外消耗。

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

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-store-catalog-<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/套餐到期/需充值/请充值",或类似含义的内容。

官方参考索引

能力文档
listCatalogCategorieslistCatalogCategories
searchCatalogItemssearchCatalogItems
getCatalogItemgetCatalogItem

Prerequisites

  1. 依赖 linkfox-amazon-store-auth;python scripts/check_auth_dependency.py,exit 42 时需先安装授权 skill。
  2. 应用需具备 Catalog Items 相关角色;searchCatalogItems 按 identifiers+SKU 检索时 query 须带 sellerId(脚本在 identifiersType=SKU 时自动使用入参 sellerId)。

Current Capabilities

能力path脚本
listCatalogCategoriescatalog/v0/categorieslist_catalog_categories.py
searchCatalogItemscatalog/{2022-04-01|2020-12-01}/itemssearch_catalog_items.py
getCatalogItemcatalog/{version}/items/{asin}get_catalog_item.py

默认 Catalog Items 版本:2022-04-01;入参 catalogItemsVersion 可改为 2020-12-01。

共享模块:_spapi_catalog_common.py。


Quick Parameters

  • listCatalogCategories:marketplaceId + asin 或 sellerSku(二选一)。
  • searchCatalogItems:marketplaceIds + keywords 或 identifiers + identifiersType(互斥);可选 includedData、brandNames、classificationIds、pageSize、pageToken。
  • getCatalogItem:asin、marketplaceIds;可选 includedData、locale。

Scripts

bash
export LINKFOXAGENT_API_KEY="<your-key>"

python scripts/list_catalog_categories.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","asin":"B08N5WRWNW"}'

python scripts/search_catalog_items.py '{"sellerId":"A1...","region":"NA","marketplaceIds":["ATVPDKIKX0DER"],"keywords":["wireless mouse"]}'

python scripts/get_catalog_item.py '{"sellerId":"A1...","region":"NA","asin":"B08N5WRWNW","marketplaceIds":["ATVPDKIKX0DER"],"includedData":["summaries","images"]}'

Display Rules

  1. 先看 developerProxy.errcode / httpStatus,再读 categories / catalogItems / catalogItem。
  2. listCatalogCategories 使用 v0 查询键 MarketplaceId(单数),与 search/get 的 marketplaceIds 不同。
  3. 网关 path 白名单需包含 catalog/v0/ 与 catalog/2022-04-01/(或 2020-12-01)。

Important Limitations

  • 本 skill 读的是 Amazon 商品目录(Catalog),不是卖家订单;订单见 linkfox-amazon-store-orders。
  • includedData、返回字段以 Amazon schema 为准,详见 references/api.md。

Amazon SP-API 接口保护与重试指引

同一店铺连续收到 Amazon SP-API 的 400、403、404 或 429 时,网关会返回 450、453、454 或 459 并短暂冷却。这些自定义状态码不是 Amazon 原生状态,也不表示封号;目的是避免持续异常或高频调用扩大店铺风险。

状态与 message范围触发与冷却处理
450:400,请求异常,请优化您的参数店铺+接口60 秒内超过 3 次:5 分钟;10 分钟内超过 4 次:20 分钟停止原参数重试,检查必填字段、marketplace、ID、日期和请求体
453:403,店铺未授权,请先授权店铺全部接口60 秒内超过 2 次:5 分钟;10 分钟内超过 4 次:30 分钟停止该店铺调用,检查授权、权限、店铺归属和区域
454:404,资源不存在,请优化您的参数店铺+接口60 秒内超过 3 次:5 分钟;10 分钟内超过 4 次:30 分钟确认资源 ID、所属店铺/站点、资源状态和接口路径
459:429限流中,请降低频率店铺+接口首次:15 秒;2 分钟内超过 2 次:30 秒;3 分钟内超过 4 次:2 分钟降低并发、分页和轮询频率并逐级退避
  • 立即停止自动或并发重试,不得通过换脚本或重复创建任务绕过保护;优先遵循 retryAfter、blockedUntil,没有时按表中时长说明。
  • 450/453/454 必须先修正参数、授权或资源标识,冷却后最多谨慎重试一次;再次触发则停止调用。453 期间停止该店铺全部 SP-API。
  • 保留已有 reportId、feedId 等任务 ID;写操作结果不确定时先查询状态,不直接重放。
  • 向用户先说明店铺保护,再给原因、处理和等待时间。可回复:“为保护您的亚马逊店铺安全,检测到 Amazon SP-API 连续返回{原因},当前已进入短暂保护。请先{处理动作},预计{等待时间}后再试;这不代表封号,也不是套餐或算力限制。”不要只说“LinkFox 限流”或“服务器繁忙”。

算力消耗规则

不消耗算力。

Feedback: skillName:linkfox-amazon-store-catalog。


更多跨境 skill: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 8 other files (scripts, references) in skills/linkfox-amazon-store-catalog of linkfox-ai/linkfox-skills.

  • SKILL.md
  • references/api.md
  • references/onboarding.md
  • scripts/_spapi_catalog_common.py
  • scripts/check_auth_dependency.py
  • scripts/get_catalog_item.py
  • scripts/list_catalog_categories.py
  • scripts/onboarding.py
  • scripts/search_catalog_items.py

Open the folder on GitHubat commit 38fef04

Compare with similar skills

Linkfox Amazon Store Catalog 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 Amazon Store Catalog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linkfox Amazon Store Catalog this skilllinkfox-ai/linkfox-skills107—~1.3kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k47 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use29k6 repos~3kAutomated safety check: PassMIT
PPT Masterhugohe3/ppt-master59k1 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 47 repos~2k tokens
    Documents & OfficeAuto-check passed
  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    29k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    59k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed
  • Scikit Learn

    zLanqing/codex-claude-academic-skills

    Machine learning in Python with scikit-learn. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 16 repos~3.9k tokens
    Data & AnalyticsAuto-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 Amazon Store Catalog

What does Linkfox Amazon Store Catalog do?

亚马逊商品目录(Catalog Items)查询。用于按 ASIN 获取目录详情,按关键词、标识符或分类条件搜索商品,以及查询商品类目节点、标题摘要、图片和其他 includedData。用户提到亚马逊商品目录、Catalog Items、ASIN…. Linkfox Amazon Store Catalog is an agent skill from linkfox-ai/linkfox-skills.

How do I install Linkfox Amazon Store Catalog in Claude Code?

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

How do I install Linkfox Amazon Store Catalog in Codex?

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

Can I use Linkfox Amazon Store Catalog 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-amazon-store-catalog -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-amazon-store-catalog, .gemini/skills/linkfox-amazon-store-catalog, .github/skills/linkfox-amazon-store-catalog and .opencode/skills/linkfox-amazon-store-catalog in your project.

What does Linkfox Amazon Store Catalog need to run?

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

Does Linkfox Amazon Store Catalog access the network?

SKILL.md names 2 domains. As links in the text: developer-docs.amazon.com and skill.linkfox.com. This is read from the text; nothing was executed.

Is Linkfox Amazon Store Catalog 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 Amazon Store Catalog use?

Linkfox Amazon Store Catalog 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 Amazon Store Catalog use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Linkfox Amazon Store Catalog?

Skills that share tags, products or a category with Linkfox Amazon Store Catalog: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linkfox Amazon Store Catalog?

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.