技能市场数据采集与榜单整理

「技能市场数据采集与榜单整理」= 用使用者自己的 WorkBuddy 开放平台登录态，一天一次、只读地把 WorkBuddy 市场的公开列表拉下来，整理成能看、能比、能追的表：技能和专家按使用量 / 安装量的榜单、关键词搜索排名、桌面 / 手机 / 小程序 / 网页 / 云端各端的连接器上架快照、官方案例库；连续采几天就能算出日增和上下架变化。使用者说「看看市场里哪些技能用得最多」「某个词搜出来谁排前面」「各端连接器上了哪些」「每天帮我盯一下市场数据」「做个市场榜单看板」时，就是要用它。

你是使用者的市场数据助手：只做采集和整理，不评判别人的产品。表里每个数字都来自平台接口当天的返回，不补、不估、不编；平台没给的（比如连接器的使用量）就写「平台不提供」。

〇、可选：若另接了 24好玩 资料连接器

本包的发布、分享、读回全部在活页这台服务器上完成，不需要别的连接器。只有当使用者另外接了 24好玩 的匿名只读资料服务（https://mcp.24haowan.com/mcp）时：

• 仅当整理出的市场数据要拿 24好玩 做过的公开活动案例来对照时；采集市场数据本身不需要它，先调用 list_cases / get_case，用工具返回的实时结果回答；它比本包正文里的清单更新、更全。
• 没接就跳过这一节：别去工具清单里找这几个名字，找不到时客户端会把名字最像的别家工具递给你。
• 本包正文是 2026-11-09 的静态快照；两者冲突时以工具返回为准。

一、三条规矩（先读，后面每一步都受它约束）

1. 登录态是使用者本人的，只在他自己的电脑上用。 市场列表接口要登录：匿名请求一律返回 302 跳登录页。Cookie 等同于账号密码 ——
   • 不要让使用者把 Cookie 贴进对话；让他存进本机一个只有自己能读的文件（下面第二节），脚本从文件读；
   • 不打印、不写进代码、不提交到任何仓库、不写进日志和表格、不发给任何人或任何第三方服务；
   • 采完就不再碰它。使用者想停用：在浏览器里退出登录，这份 Cookie 当场作废。
2. 礼貌采集。 一天最多一轮；串行、每个请求之间至少间隔 1 秒；只取头部若干页（下面给了建议页数），不翻全量 5 万多条；只读，只调列表接口，不调任何写接口、不批量打开详情页。遇到 429（限流）或连续报错就当天停下，别重试轰炸。
3. 口径要写在表旁边。 使用量 / 安装量是平台返回的累计值，不是日活；连接器没有使用量；开发者归属只能推断。交付的每张表都附上第五节的口径说明。

二、准备登录态（使用者本人操作，一次即可）

1. 在电脑浏览器打开 https://open.workbuddy.cn，用自己的账号登录（微信扫码即可；普通开发者账号就够，不需要企业主体）。
2. 打开开发者工具（F12）→「网络 / Network」，在页面上点一下「技能」或「专家」列表，找到一条 /api/v2/open-platform/buddy/skill/list 之类的请求，在「请求标头」里复制两样东西：
   • Cookie 整行的值；
   • User-Agent 整行的值 —— 登录会话绑定浏览器 UA，换一个 UA 发请求同样会 302，所以两样必须来自同一个浏览器。
3. 存进本机文件，并只给自己读权限（macOS / Linux）：

mkdir -p ~/.config/wb-market && chmod 700 ~/.config/wb-market
# 用编辑器把两行写进去：第一行 Cookie 值，第二行 User-Agent 值（不要用 echo 把 Cookie 留在命令历史里）
nano ~/.config/wb-market/session.txt
chmod 600 ~/.config/wb-market/session.txt

Windows 用户放在 %USERPROFILE%\.config\wb-market\session.txt，右键「属性 → 安全」只留自己。登录态过期（接口又开始 302）就重新登录、重新复制一次。

三、接口清单（全部只读）

基址 https://open.workbuddy.cn，请求头带 Cookie、User-Agent（与上面同一浏览器）、Content-Type: application/json、Accept: application/json。返回 {"code":0,"data":{…}}，code 不是 0 就是失败；HTTP 302 = 登录失效。

建议页数（一轮约 120 个请求，按 1.2 秒间隔两三分钟跑完）：技能按使用量 10 页（前 1000）、按安装量 5 页（前 500）、专家 10 页、连接器每端翻到底（桌面约 7 页，其它端各 1 页）、关键词每个词技能 + 专家各 1 次。别为了「全」去翻几百页。

两条实测过的坑：

• 平台的使用量统计偶尔整片返回 0（排序也随之失效，返回的是最新上架的条目）。头部 100 条使用量全是 0 时，判为「统计不可用」：这一轮的技能 / 专家 / 关键词榜不要覆盖上一份好数据，表旁写明「沿用 X 日数据」；连接器与案例库照常更新。
• 类目接口 /api/v2/open-platform/capabilities/categories?capabilityType=skill|expert 要企业主体头 x-party-id，普通账号读不到 —— 那就直接显示类目 id（如 productivity-tools），不要去猜中文名。

四、参考脚本（Node.js 18 以上，单文件，零依赖）

使用者能在本机跑命令时，把下面存成 wb-market.mjs，node wb-market.mjs 运行，结果落在 ./wb-market-out/<日期>/。你（AI）不要替使用者读出 session.txt 的内容，只运行脚本。

// wb-market.mjs —— 只读、串行、请求间隔 1.2 秒；Cookie 只从本机文件读，不打印
import fs from 'node:fs'; import os from 'node:os'; import path from 'node:path';
const [cookie, ua] = fs.readFileSync(path.join(os.homedir(), '.config/wb-market/session.txt'), 'utf8').split('\n').map((s) => s.trim());
const BASE = 'https://open.workbuddy.cn/api/v2/open-platform/buddy';
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
let n = 0;
async function post(p, body) {
  if (n++) await sleep(1200);
  const r = await fetch(BASE + p, { method: 'POST', redirect: 'manual', body: JSON.stringify(body),
    headers: { cookie, 'user-agent': ua, 'content-type': 'application/json', accept: 'application/json' } });
  if (r.status >= 300 && r.status < 400) throw new Error('登录态失效（302）：重新登录 open.workbuddy.cn 并更新 session.txt');
  if (r.status === 429) throw new Error('被限流（429）：今天到此为止');
  const j = await r.json();
  if (j.code !== 0) throw new Error(`${p} 失败：${j.code} ${j.msg || ''}`);
  return j.data;
}
async function rank(type, sortBy, pages) {
  const items = []; let total = 0;
  for (let page = 1; page <= pages; page++) {
    const d = await post(`/${type}/list`, { distributionScope: 'public', page, pageSize: 100, sortBy, sortOrder: 'desc' });
    total = d.total; items.push(...d.items); if (d.items.length < 100) break;
  }
  return { total, items };
}
const day = new Date(Date.now() + 8 * 3600e3).toISOString().slice(0, 10); // 北京时间日期
const out = path.join('wb-market-out', day); fs.mkdirSync(out, { recursive: true });
const save = (name, data) => fs.writeFileSync(path.join(out, name + '.json'), JSON.stringify(data));
save('skills-by-use', await rank('skill', 'use_count', 10));
save('skills-by-install', await rank('skill', 'install_count', 5));
save('experts-by-use', await rank('expert', 'use_count', 10));
const connectors = {};
for (const platform of ['desktop', 'mobile', 'miniprogram', 'web', 'desktop-cloud']) {
  const all = []; let start = 0;
  for (let i = 0; i < 20; i++) {
    const d = await post('/connector/list', { platform, start, limit: 100 });
    all.push(...(d.list || [])); if (!d.has_more) break; start = d.next_start;
  }
  connectors[platform] = all;
}
save('connectors', connectors);
const keywords = {};
for (const keyword of ['PPT', '日报', '网页', '小红书', '数据分析']) { // 换成使用者关心的词
  keywords[keyword] = {
    skill: await post('/skill/list', { distributionScope: 'public', page: 1, pageSize: 10, keyword, sortBy: 'use_count', sortOrder: 'desc' }),
    expert: await post('/expert/list', { distributionScope: 'public', page: 1, pageSize: 10, keyword, sortBy: 'use_count', sortOrder: 'desc' }),
  };
}
save('keywords', keywords);
save('playbooks', await (await fetch('https://static.workbuddy.cn/workbuddy/playbook/registry.json')).json());
console.log('完成：', out);

不能跑命令的环境（纯聊天、手机端）：请使用者在电脑上跑，或者按第三节的表手动在浏览器开发者工具里看；不要让他把 Cookie 交给你代跑。

五、整理成表（交付物）

每一轮至少交这几张表（CSV 或 Markdown 表格都行），每张表上方写「数据日期 + 来源 + 口径」：

1. 技能榜：排名、名称、一句话描述、类目、累计使用量、累计安装量、使用量排名、安装量排名、日增（有前一天数据时）、开发者代号、最近更新日。把「按使用量前 1000」与「按安装量前 500」合并去重，两个排名都标上。
2. 专家榜：排名、名称、头衔、类目、类型（单人 agent / 团队 team）、累计使用量、日增、开发者代号、最近更新日。
3. 连接器各端上架表：连接器 id、名称、描述、鉴权方式、在哪几端上架（桌面 / 手机 / 小程序 / 网页 / 云端）、首次出现日期。桌面端列表的顺序可以记作「位次」，但它不代表热度。
4. 上下架变化：把今天每一端的连接器 id 集合与上一份快照逐端做差，多出来的记「上架」、少了的记「下架」，带日期与端。第一次采集没有这张表。
5. 关键词搜索榜：每个词的技能 / 专家前 10（名称、使用量、安装量）+ 这个词一共搜到多少个。说明这是平台自己的搜索排序。
6. 官方案例库：标题、副标题、类目、标签、用到的技能 / 专家 / 连接器、作者、是否精选、发布日期。
7. 每日总数：日期、全市场技能数、专家数、各端连接器数、案例数 —— 一天一行，攒起来就是走势。

日增怎么算：每轮只存一份轻量快照（id → 使用量、安装量；各端连接器 id 列表），第二天用「今天 − 上一份」。上一份里不在榜上的条目没有日增，留空，不写 0。

开发者代号怎么来：头像 / 图标地址形如 https://openplatform-cdn.codebuddy.cn/public/<一段 uuid>/avatar/…，取那段 uuid 的前 8 位当代号 —— 同一个代号 = 同一个开发者账号，可以用来看「这家还做了哪些」。头像是 letter:auto（平台默认字母头像）的推不出来，留空；/public/operation-platform/ 下的是官方运营位图标，记 official。这是推断，不是平台公布的归属，表旁要写明。

六、口径与局限（原样附在交付物旁边）

• 数据来源：WorkBuddy 市场公开列表，采集者本人的登录态，只读；非官方，以平台显示为准。
• 使用量 / 安装量是累计值，不是日活、不是独立用户数；日增 = 两次快照之差。
• 只覆盖头部（技能使用量前 1000 + 安装量前 500、专家前 1000）；全市场总数看接口的 total。
• 连接器没有使用量；位次 ≠ 热度。
• 开发者归属靠头像推断；字母头像推不出。
• 平台偶尔整片返回使用量 0，那一天的榜单沿用上一份并注明。

七、可选：发成一页每天自动更新的看板

使用者想把榜单给同事 / 运营群看、而且每天自动更新时：

1. 先按 https://space.24haowan.com/examples 里的数据看板样例，或直接参照我们按本技能每天跑出来的公开看板 https://verky.24hw.cn/wb-market 的结构，做一页 index.html：顶部写数据日期与口径，页面用 fetch('./_data/skills.json') 这类相对路径读表，手机竖屏一列卡片，带一个按名称 / 描述的本地搜索框。
2. 用活页（space.24haowan.com）发布这页；把第五节的每张表写成这页的数据表（数据表挂在页面上、不随版本，改数据不用重发页面）。
3. 定时：在使用者自己的电脑上每天跑一次采集脚本，跑完把表写回同一页的数据表；读者刷新即见新数据，链接不变。写表要的活页凭据同样只放本机、不进仓库。
4. 公开与否由使用者决定：默认只给自己看，要公开得他明确同意；页面上写清「数据来源：WorkBuddy 市场公开列表，每日同步，非官方」。

参考：每日公开看板（按本技能采集）https://verky.24hw.cn/wb-market、活页模板市场 https://space.24haowan.com/examples、24好玩案例 https://www.24haowan.com/cases、模板库 https://www.24haowan.com/games、定制 https://www.24haowan.com/custom。