SuperAPI AI 工具集

fastmoss-market

数据与分析

查看项目

更新于 10-16 06:23

技能介绍

用途:抓取并分析 FastMoss(fastmoss.com)TikShop 的“品类大盘”数据,仅覆盖该板块的两个页面:行业格局(market-category)与市场总览(market-analyze)。产品、达人、店铺、广告、视频、直播等数据需使用对应的姊妹技能。

主要能力:因两页均为图表型仪表盘,无表格可抓,故采用 API 优先方式,直接调用以下 JSON 端点:GET /api/analysis/V2/categoryDistribution(行业格局散点,按地区×品类返回销售额与增长)、GET /api/analysis/GoodCategory/base(市场总览:总销售额、商品数、头部商品)、GET /api/analysis/GoodCategory/salesChart(品类销售额/商品/达人/视频/直播的每日时间序列)、GET /api/analysis/GoodCategory/priceDistribution(价格带分布)、GET /api/analysis/GoodCategory/filterInfo(词表:27 个品类码 + 16 个国家码)。脚本通过页面上下文 fetch() 调用,自动携带用户会话 Cookie,无需单独处理鉴权。

使用方式:前置条件为 Kimi WebBridge 守护进程健康(~/.kimi-webbridge/bin/kimi-webbridge status 应返回 running 与 extension_connected 均为 true),且浏览器已登录 fastmoss.com。常用命令:python <path-to-skill>/scripts/fetch_distribution.py --region US --time month --out <out-dir>/us_categories.csv;多国对比可传 --region US,ID,TH,MY;python <path-to-skill>/scripts/fetch_base.py --region US --out <out-dir>/us_market_base.json;python <path-to-skill>/scripts/fetch_sales_chart.py --region US --out <out-dir>/us_sales_chart.csv;python <path-to-skill>/scripts/analyze.py --distribution <out-dir>/categories_by_region.csv --out-md <report>.md。各脚本可用 --help 查看完整参数。

参数:--region 支持 US、ID、GB、VN、TH、MY、PH、ES、MX、DE、FR、IT、BR、JP、SG、SA,空字符串表示全球;--time 对 categoryDistribution 支持 28d(默认,近 28 天)与 month(最近完整月份,发送 date_value=YYYY-MM);base/salesChart/priceDistribution 的 --action 1 为日粒度。

限制与注意:页面须先加载才能 fetch,脚本会先导航到 /zh/market/market-category;_time 与 cnonce 为防缓存参数,由模板自动添加;接口一次性返回全部数据,无需分页;region 空字符串不等于 region=Global,全球聚合需完全省略该参数;evaluate 返回字符串,需经 JSON 往返解析;Windows 下读取 CSV 建议 encoding='utf-8-sig';CSV 均为 utf-8-sig(BOM)。默认会话名为 fastmoss-market,任务结束可调用 close_session 关闭。更多细节见 references/environment.md、api_notes.md、analysis_recipe.md。