SuperAPI AI 工具集

fastmoss-shops

数据与分析

查看项目

更新于 10-16 06:23

技能介绍

用途:采集并分析 FastMoss(fastmoss.com)TikTok 店铺榜单数据,范围限于该站的店铺板块(店铺销量榜、店铺热推榜两项榜单,以及店铺搜索入口)。商品、达人、广告、视频、直播需使用对应的姊妹技能。

主要能力:驱动用户已登录的浏览器提取店铺行数据为 CSV;两个榜单各有一套指标列,脚本动态读取 thead,因此列结构随榜单变化,自动捕获;店铺列会预解析为 shop_name、shop_legal_name、shop_category、shop_rating;附带聚合脚本与 Markdown 报告模板可产出分析报告。

榜单 URL:销量榜 https://www.fastmoss.com/zh/shop-marketing/tiktok;热推榜 https://www.fastmoss.com/zh/shop-marketing/hotTiktok;搜索页 https://www.fastmoss.com/zh/shop-marketing/search。使用 /zh/ 中文语言,站点为 NUXT/Vue SPA,需等待水合(--nav-sleep 6+)。

使用方式:先确认 Kimi WebBridge 守护进程健康(~/.kimi-webbridge/bin/kimi-webbridge status,期望 {"running": true, "extension_connected": true}),异常时调用 Skill(kimi-webbridge) 按 references/operations.md 处理;并确保浏览器已登录 fastmoss.com。写新 shell 或 evaluate JS 前先阅读 references/environment.md(Windows、bash、无 jq、heredoc 转义规则)。抓取示例:python <path-to-skill>/scripts/shop_scraper.py --ranking sales --pages 5 --out <out-dir>/sales.csv。多国筛选:python <path-to-skill>/scripts/shop_filtered.py --ranking sales --country 美国,印度尼西亚,泰国,马来西亚 --pages 3 --out <out-dir>/sales_by_country.csv。聚合报告:python <path-to-skill>/scripts/analyze.py --sales <out-dir>/sales.csv --hot <out-dir>/hot.csv --out-md <report>.md。脚本可用 --help 查看完整参数。

国家筛选词表(16 个市场):全部、美国、印度尼西亚、英国、越南、泰国、马来西亚、菲律宾、西班牙、墨西哥、德国、法国、意大利、巴西、日本、新加坡。

输出 CSV 基础列:page、ranking、rank、shop_name、shop_legal_name、shop_category、shop_rating、country,外加 thead 中每个中文表头对应一列;使用筛选脚本时前置 filter_country 与 filter_country 类附加列(资料列出 filter_country)。编码为 utf-8-sig。

限制与注意事项:店铺搜索页返回卡片而非表格,未被打包脚本覆盖,需自行编写 evaluate(填入搜索框、等待卡片、DOM 提取)。快照 @e 引用在每次导航后失效,脚本按文本点击;heredoc 会吃掉一层反斜杠,避免在 heredoc 中使用 JS 正则;thead 首次渲染可能 innerText 为空,脚本回退到 textContent 与 title;SPA 水合延迟在店铺页可能比商品页更长;不要假定固定 CSV 结构,按 dict.keys() 遍历;jq 可能未安装;Windows 读取 CSV 需 encoding='utf-8-sig'。任务结束关闭会话:curl -d '{"action":"close_session","args":{},"session":"fastmoss-shops"}' http://127.0.0.1:10086/command。默认会话名 fastmoss-shops,可用 --session 覆盖。