前言¶
做 CS2 饰品相关的脚本、看板或对话助手时，常见做法是手写 HTTP 请求、对着文档翻接口，还要自己维护一份接口清单。CSQAQ 已经提供官方 API 与文档站点，但把「同步文档、查 endpoint、带 Token 发请求」接到 Cursor、Claude Code 等 Agent 上，仍需要一套固定的 Skill 约定。
下面介绍 SkillHub 上的 CS2市场数据查询（坐标 @user_866fdfe3/csqaq-market-lookup，版本 1.1.1）。它把 CSQAQ 的查询能力封装成通用 SKILL.md 技能，由社区发布者 user_866fdfe3 维护；技能作者标注为 ephron_ren，数据与分析分类为 data-analysis，SkillHub 标签 requires_api_key=true。
这是什么¶
一句话：通过 CSQAQ API 查询 CS2 饰品市场价格、交易数据及相关统计，并在本地同步官方 API 目录后，用 CLI 或 Agent 调用。
数据来源与认证归属 CSQAQ（官网 https://csqaq.com/，文档 https://docs.csqaq.com/）。技能本身提供 scripts/csqaq_api.py 统一入口，不替代 CSQAQ 账号与 Token 申请流程。
核心功能¶
以下能力均来自技能包内 SKILL.md 与 references/endpoints.md（当前同步目录共 39 个接口）：
- 饰品与价格：批量/全量价格、按
market_hash_name查价、饰品详情与列表、联想搜索等（如POST /api/v1/goods/getPriceByMarketHashName、GET /api/v1/info/good）。 - 走势与图表：单件图表、K 线、成交量与磨损相关数据（如
POST /api/v1/info/chart、POST /api/v1/info/simple/chartAll）。 - 市场与指数：首页数据、排行榜、热度、指数 K 线与详情（如
GET /api/v1/current_data、GET /api/v1/sub/kline）。 - 文档同步：从
https://docs.csqaq.com/sitemap.xml拉取文档，生成本地references/endpoints.json、endpoints.md、merged_openapi.json。 - 统一调用：
list浏览接口元数据，call按路径与方法发请求；认证使用请求头 ApiToken（环境变量 CSQAQ_API_TOKEN）。
技能说明中强调：CSQAQ 的均价、走势等可能存在数天到一周的延迟，重要成交价宜再对照 BUFF 等实时盘面；细节见包内 references/buff-price-verification.md。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装本技能到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。SkillHub 文档中的常用路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令（坐标与 SkillHub 页面一致）：
skillhub install @user_866fdfe3/csqaq-market-lookup --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的 Agent 目录即可。安装完成后按各客户端要求重启或重新加载技能。
也可让 AI 按 SkillHub 页面提示，参考 https://skillhub.cn/install/skillhub.md 完成安装。
3. 配置 API Token 与 Python 依赖¶
在 https://csqaq.com/ 登录后，于账号设置中获取 ApiToken，写入环境变量：
export CSQAQ_API_TOKEN="<your_token>"
技能要求 Python 3.8+，依赖 pyyaml：
pip install pyyaml
或在技能目录下：
pip install -r requirements.txt
典型用法¶
在技能根目录（含 scripts/csqaq_api.py）下操作。
首次同步 API 文档（拉取 sitemap 并更新 references/）：
python scripts/csqaq_api.py sync
查看可用接口（可限制条数）：
python scripts/csqaq_api.py list --limit 200
调用接口：当前同步的 Apifox 目录中 operationId 为空，应优先使用 --path 与 --method。示例为技能文档中的首页数据查询：
python scripts/csqaq_api.py call --path /api/v1/current_data --method GET --query type=init --pretty
带查询参数或 JSON 体时，可使用重复的 --query，或 --json-body / --body-file / --raw-body（见 SKILL.md）。
在 Agent 对话中，启用该技能后，可用自然语言描述目标（例如同步文档、列出与「饰品价格」相关的 endpoint、再调用指定路径），由模型按 SKILL.md 工作流执行上述命令。
适用场景与注意¶
适合谁
- 需要在 Agent 会话里查 CS2 饰品价、走势、排行榜、开箱统计等，又不想每次手写 curl。
- 希望本地有一份可检索的 CSQAQ 接口目录，并在官方文档改版后通过
sync刷新。
限制与注意
- 必须自备 CSQAQ_API_TOKEN；Token 不要提交到仓库或日志。
- 接口集合以同步结果为准；文档变更后需重新
sync。v1.1.1 说明已同步 39 个官方接口目录。 - 价格与成交：技能文档明确 CSQAQ 部分字段可能滞后，决策性询价应交叉验证实时市场（如 BUFF 商品页）。
- SkillHub 统计（截至页面抓取）：评分 100000，下载 834，安装 1；以 SkillHub 实时页面为准。
结尾¶
CS2市场数据查询把 CSQAQ 的文档同步与 API 调用收敛到一套 Skill + CLI，适合挂在 Cursor 等支持 skills 的客户端上做数据分析类对话。官方 SkillHub 页面：
- https://www.skillhub.cn/skills/user_866fdfe3/csqaq-market-lookup
- API 入口：https://api.skillhub.cn/user_866fdfe3/csqaq-market-lookup
