SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场ecommerce-amazon-policy-feed

ecommerce-amazon-policy-feed

营销与增长

查看项目

更新于 10-16 14:54

技能介绍

用途

该技能用于获取亚马逊面向跨境卖家的最新政策与法规动态，属于两步式（先列表、后详情）的查询流程：先按站点与时间窗口列出条目，再按条目 id 拉取文章全文。

数据来源为亚马逊面向卖家发布的官方政策与法规更新，由 AI 筛选出对跨境运营有价值的条目。每个条目包含 summaryZh 字段，即 AI 生成的 1 至 3 句中文摘要，便于快速浏览。

主要能力

该技能包含两个配套工具：

  • amazon/policyFeed：分页列表，返回标题、AI 摘要、原始 URL 和发布时间等结构化记录。
  • amazon/policyFeedDetail：按从列表获取的单个记录 id 返回完整文章正文（Markdown）。

时间范围默认为最近 7 天，可通过 publishedAtGte / publishedAtLte 自定义时间窗口。

使用方式

列表参数（amazon/policyFeed）

  • site：字符串，非必填，站点代码（大写），默认 US。站点过滤仅对部分条目类型生效，其他条目不受站点限制始终返回。
  • publishedAtGte：字符串，非必填，发布/变更时间下界（含），格式 yyyy-MM-dd HH:mm:ss，默认最近 7 天。
  • publishedAtLte：字符串，非必填，发布/变更时间上界（含），格式 yyyy-MM-dd HH:mm:ss，默认当前时间。
  • page：整数，非必填，页码，从 1 开始，默认 1。
  • pageSize：整数，非必填，每页条数，范围 1-100，默认 20。

详情参数（amazon/policyFeedDetail）

  • id：字符串，必填，来自列表响应 data[].id 的记录 ID（32 位字符串）。

支持的站点

US、JP、UK、AU、BE、BR、CA、EG、FR、DE、IN、IT、MX、NL、PL、SA、SG、ES、SE、TR、AE、ZA、IE。未指定时默认 US。站点过滤仅对部分条目类型生效，其他条目始终返回。

API 调用

接口端点：

  • POST /amazon/policyFeed（amazon_policy_feed.py，完整参数、响应与错误码见 references/api.md）
  • POST /amazon/policyFeedDetail（amazon_policy_feed_detail.py，完整参数、响应与错误码见 references/api.md）

Python 脚本：python scripts/<script_name>.py '<JSON params>' [--inline]

成本约束：该工具消耗 credits；默认在同一会话中对相同参数组合只调用一次，脚本带 24 小时本地缓存。失败或结果为空后，不要自动更换关键词、分页或邮编重试；继续操作前需告知用户会产生额外费用。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-amazon-policy-feed-<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 载入上下文。

认证

设置 NEXSCOPE_API_KEY 环境变量。若认证失败（401/402）或出现余额不足错误，访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值 credits。

如何构建查询

  1. 设定时间窗口：将用户的时间参考转换为 publishedAtGte / publishedAtLte。留空则默认最近 7 天。
  2. 选择站点：将用户的目标国家映射为 site 代码（默认 US）。注意仅对部分条目类型生效。
  3. 分页：增大 page 以浏览更深的内容；每页最多 100 条。
  4. 深入某条记录：从列表取记录 id，调用详情脚本读取全文。

使用示例

  1. 最近动态（最近 7 天，US）

{"site": "US", "pageSize": 20}

  1. 自定义日期范围

{"site": "US", "publishedAtGte": "2026-05-01 00:00:00", "publishedAtLte": "2026-05-31 23:59:59"}

  1. 日本站动态，第 2 页

{"site": "JP", "page": 2, "pageSize": 50}

  1. 单条记录全文

{"id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"}

展示规则

  • 列表视图：以表格呈现结果，含标题、AI 摘要（summaryZh）、发布时间和原始 URL 链接。
  • 详情视图：按原样渲染 stdout Markdown；响应还包含 title 和 summaryZh 作为上下文。
  • 仅呈现数据：报告 feed 所述内容，不添加主观业务建议或推测未来政策。
  • 时效性说明：数据可能比实时页面略有延迟，以亚马逊原文为准。
  • 错误处理：调用失败时，根据错误响应说明原因（例如无效 id 则从列表重新获取），而非猜测。

适用场景

适用于亚马逊官方政策与法规动态的场景：

  • “亚马逊最新的政策变化有哪些？”——最新政策动态概览
  • “过去一周亚马逊美国站的政策新闻”——按站点筛选的政策新闻
  • “亚马逊最新的政策和法规更新有哪些？”——通用政策/法规更新
  • “亚马逊 FBA 最新政策和法规”——特定主题的政策查询
  • “给我看这条政策更新的全文”——按 id 获取文章全文
  • “Amazon latest policy updates”——英文触发

限制

  • 默认窗口为 7 天：未显式传入时间参数时，仅返回最近 7 天。
  • 每页最多 100 条：pageSize 范围为 1-100。
  • 详情需要有效的列表 id：amazon/policyFeedDetail 仅接受 amazon/policyFeed 返回的 id；未知 id 会返回错误。
  • 不用于聚合：该技能输出为长文本与元数据，不适合通过数据查询工具进行二次统计/聚合分析。

不适用场景（超出政策与法规动态范围）：

  • 商品/关键词/销售分析、listing 优化、评论分析
  • 实时店铺搜索结果或商品详情
  • 单个卖家账户内的账户专属通知
  • 历史专利或商标检索

边界判断：如果用户想要亚马逊面向卖家官方发布的政策、法规或合规更新（及其全文），则该技能适用；如果想要商品/关键词/销售数据，应使用相应的数据技能。