Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
linkfox-ai avatar

Linkfox Amazon Store Report

linkfox-ai/linkfox-skills

  • 237 installs
  • 64 repo stars
  • Updated August 3, 2026
  • linkfox-ai/linkfox-skills

Helps with ai & agent building tasks.

About

linkfox-amazon-store-report is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.

  • linkfox-amazon-store-report
  • AI & Agent Building
  • AI-coding skill

Linkfox Amazon Store Report by the numbers

  • 237 all-time installs (skills.sh)
  • +36 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #2,640 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-amazon-store-report

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs237
repo stars★ 64
Last updatedAugust 3, 2026
Repositorylinkfox-ai/linkfox-skills ↗

What it does

Helps with ai & agent building tasks.

Files

references/api.mdMarkdownGitHub ↗

Amazon 店铺报告 API Reference

本文档描述 报告获取 相关的 API。授权与令牌相关接口（/spApi/authorizeUrl、/spApi/storeTokens、/spApi/refreshToken 等）属于 依赖 skill linkfox-amazon-store-auth，请参考该 skill 的 references/api.md。

⚠️ 依赖提示：在调用本 skill 接口前，请先确认 linkfox-amazon-store-auth 已安装（参见本 skill 的 SKILL.md 顶部 Prerequisites）。

Calling Conventions

  • Base URL: https://tool-gateway.linkfox.com（默认；可用 STORE_API_BASE_URL 或兼容旧名 SPAPI_BASE_URL 覆盖）
  • Request Method: POST
  • Content-Type: application/json
  • Authentication: Header Authorization: <api_key>，读取环境变量 LINKFOXAGENT_API_KEY

API Endpoints

1. Developer Proxy（转发亚马逊开放接口）

Endpoint: /spApi/developerProxy

报告相关的上游调用（列表 / 请求 / 查状态 / 取下载链接）都通过该代理接口转发。

Request Parameters (JSON):

ParameterTypeRequiredDescriptionExample
regionstringYes区域代码：NA/EU/FE"NA"
pathstringYes上游 Reports 等 API 路径（不含域名与 developer-proxy/{region}/ 前缀）"reports/2021-06-30/reports"
methodstringYesHTTP 方法：GET/POST/PUT/DELETE"GET"
amzAccessTokenstringYes访问令牌（来自 /spApi/storeTokens）"Atza\
queryStringstringNoQuery 参数（无 ?）"marketplaceIds=ATVPDKIKX0DER"
bodystringNoPOST/PUT 请求体（JSON 字符串）"{\"reportType\":\"...\"}"
contentTypestringNoContent-Type 头（默认 application/json）"application/json"

Response:

{
  "errcode": 200,
  "errmsg": "ok",
  "httpStatus": 200,
  "contentType": "application/json",
  "body": "{\"reports\":[...]}"
}

Important Notes:

  • path 必须在白名单内（后端 sp-api.developer-proxy.allowed-path-prefixes）
  • 默认白名单含 reports/2021-06-30/reports
  • amzAccessToken 必须与 region 匹配的店铺令牌一致
  • 速率限制按上游亚马逊接口端点执行

---

createReport 请求体（POST reports/2021-06-30/reports）

developerProxy 的 body 为 JSON 字符串，反序列化后与 Amazon CreateReport 请求体一致。

通用字段

字段类型必填说明
reportTypestring是报告类型枚举，见 references/report-types.md
marketplaceIdsarray[string]是站点 ID 列表（多数报告至少一个）
dataStartTimestring视报告ISO 8601；部分 schema 仅使用日期部分 YYYY-MM-DD
dataEndTimestring视报告同上
lastUpdatedDatestring视报告部分 Vendor 报告要求，与日期字段组合以官方 schema 为准
reportOptionsobject视报告Brand Analytics、销售流量、促销/优惠券、部分 Vendor 等必填；键与枚举见各报告专页

与官方 JSON Schema 的对应关系

Amazon 在仓库 amzn/selling-partner-api-models/schemas/reports 中为 带 JSON 结果包裹 的报告提供了 Schema（含 reportSpecification 示例与结果字段定义）。

本 skill 在 references/report-requests/ 下为 *每个 `.json 维护一份同名 .md`*，内容包括：

  • 上游 Raw 链接与摘要说明
  • 从 schema 提取的 `reportType` 与 `reportSpecification` 官方示例（可直接作为 body 模板）
  • `reportOptions` 键表（若有）
  • 结果文档结构说明要点

入口索引：report-requests/README.md 按 `reportType` 全覆盖（109 个）：report-requests/types/README.md

大量 Flat File（订单、库存等 TSV）报告在官方仓库中无独立 schemas/reports/*.json 时，请求体通常为 reportType + marketplaceIds + 可选 dataStartTime/dataEndTime，详见 Report type values。

脚本参数映射（scripts/get_report.py）

JSON 参数写入 createReport 体
reportTypereportType
marketplaceIdsmarketplaceIds
dataStartTimedataStartTime
dataEndTimedataEndTime
lastUpdatedDatelastUpdatedDate
reportOptionsreportOptions（对象原样合并）

---

与依赖 skill 的接力关系

下面是典型调用序列（本 skill + linkfox-amazon-store-auth）：

linkfox-amazon-store-auth/scripts/store_tokens.py    # 取 accessToken
           │
           ▼
linkfox-amazon-store-report/scripts/get_report.py    # 用 accessToken 拉报告
  1. POST /spApi/developerProxy (method=POST,  path=reports/2021-06-30/reports)
  2. POST /spApi/developerProxy (method=GET,   path=reports/2021-06-30/reports/{reportId})  # 轮询
  3. POST /spApi/developerProxy (method=GET,   path=reports/2021-06-30/documents/{reportDocumentId})
  4. 直接下载返回的 url 并解压

Error Codes

errcode含义建议动作
200代理调用成功（还需看 httpStatus）继续解析 body
1002缺参数或认证失败检查必填参数与 API key
1003第三方服务调用失败稍后重试
1005path 不在白名单联系后端加白名单

Developer Proxy 上游状态码

调用成功（errcode=200）后必须再检查 httpStatus：

httpStatus含义建议动作
200成功正常解析 body
202已接受（创建报告后返回）拿到 reportId 进入轮询
400参数错误检查 reportType / marketplaceIds
403未授权检查 accessToken、店铺权限、品牌备案
404资源不存在核对 reportId/reportDocumentId
429请求过快指数退避重试
500上游错误延时重试

---

curl Examples

列出现有报告

curl -X POST https://tool-gateway.linkfox.com/spApi/developerProxy \
  -H "Authorization: $LINKFOXAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "NA",
    "path": "reports/2021-06-30/reports",
    "method": "GET",
    "amzAccessToken": "Atza|IwEBI...",
    "queryString": "reportTypes=GET_MERCHANT_LISTINGS_ALL_DATA&marketplaceIds=ATVPDKIKX0DER"
  }'

请求新报告

curl -X POST https://tool-gateway.linkfox.com/spApi/developerProxy \
  -H "Authorization: $LINKFOXAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "NA",
    "path": "reports/2021-06-30/reports",
    "method": "POST",
    "amzAccessToken": "Atza|IwEBI...",
    "body": "{\"reportType\":\"GET_MERCHANT_LISTINGS_ALL_DATA\",\"marketplaceIds\":[\"ATVPDKIKX0DER\"]}",
    "contentType": "application/json"
  }'

查询报告状态

curl -X POST https://tool-gateway.linkfox.com/spApi/developerProxy \
  -H "Authorization: $LINKFOXAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "NA",
    "path": "reports/2021-06-30/reports/<reportId>",
    "method": "GET",
    "amzAccessToken": "Atza|IwEBI..."
  }'

获取下载链接

curl -X POST https://tool-gateway.linkfox.com/spApi/developerProxy \
  -H "Authorization: $LINKFOXAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "NA",
    "path": "reports/2021-06-30/documents/<reportDocumentId>",
    "method": "GET",
    "amzAccessToken": "Atza|IwEBI..."
  }'

---

Feedback API

本接口与上面工具 API 不同 base URL，不要混用。
  • POST https://skill-api.linkfox.com/api/v1/public/feedback
  • Content-Type: application/json
{
  "skillName": "linkfox-amazon-store-report",
  "sentiment": "NEGATIVE",
  "category": "BUG",
  "content": "Report FATAL for Brand Analytics, but store lacks brand registry — error not surfaced clearly."
}

Field rules:

  • skillName: 使用本 skill frontmatter 的 name
  • sentiment: POSITIVE / NEUTRAL / NEGATIVE
  • category: BUG / COMPLAINT / SUGGESTION / OTHER
  • content: 用户说了什么、实际发生了什么、为什么是问题

---

报告类型索引

完整列表见 references/report-types.md（95+ 种）。精简摘要见 references/report-types-basic.md。

带 schema 的请求/结果格式：references/report-requests/README.md（与 GitHub schemas/reports 一一对应）。

Related skills

mattpocockSetup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196kopen.feishu.cnLark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402kjuliusbrusseeCavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7klarksuiteLark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16kxixu-meRunning Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72runcomfy-comCodex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10
AI & Agent Buildingagents
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.