shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

CS2市场数据查询

CS2市场数据查询 - 使用 CSQAQ API 查询 CS2 饰品市场价格、交易数据等

personAuthor: user_866fdfe3hubcommunity
downloadDownload package

CSQAQ Market Lookup

CS2 市场数据查询技能，使用 CSQAQ API 查询 CS2 饰品市场价格、交易数据等。

概述

该技能允许你通过 CSQAQ API 查询 CS2 市场数据，包括：

  • 饰品当前价格
  • 历史价格走势
  • 市场交易数据
  • 饰品详细信息

配置

获取 API Token

  1. 访问 https://csqaq.com/
  2. 登录你的账号
  3. 在账号设置中找到 API Token 管理页面
  4. 复制你的 ApiToken

设置环境变量

# Linux/macOS
export CSQAQ_API_TOKEN="<your_token>"

# Windows PowerShell
$env:CSQAQ_API_TOKEN="<your_token>"

使用方法

同步 API 文档

首次使用前，需要同步 CSQAQ 的 API 文档：

python scripts/csqaq_api.py sync

查看可用接口

python scripts/csqaq_api.py list --limit 200

调用 API

通过路径和方法调用：

python scripts/csqaq_api.py call --path /api/v1/current_data --method GET --query type=init

当前同步的 Apifox 文档未提供 operationId（references/endpoints.json 中为空），请优先使用路径和方法调用。对于包含 operationId 的旧版本地目录，仍可使用：

python scripts/csqaq_api.py call --operation-id <operation-id> --query key=value

如果 operationId 不唯一，添加 --doc-id。

工作流程

  1. 运行 sync 从 https://docs.csqaq.com/sitemap.xml 拉取所有 API 文档
  2. 使用 list 查找目标接口的元数据（path, method, operationId, tags, summary）
  3. 使用 call 调用接口；当前目录优先使用 --path + --method，旧版目录也支持 --operation-id
  4. 对于写入操作，使用 --json-body、--body-file 或 --raw-body 传递请求体
  5. 如果接口集合变化，重新运行 sync 刷新本地数据

文件结构

  • SKILL.md - 本文件，技能说明文档
  • scripts/csqaq_api.py - 统一 CLI 工具
  • references/endpoints.json - 结构化接口目录
  • references/endpoints.md - 人类可读的接口列表
  • references/merged_openapi.json - 合并后的 OpenAPI 文档
  • references/sync_meta.json - 同步元数据和诊断信息

依赖

  • Python 3.8+
  • pyyaml

安装依赖：

pip install pyyaml

示例

查询当前市场价格

# 同步文档
python scripts/csqaq_api.py sync

# 查看所有接口
python scripts/csqaq_api.py list

# 调用特定接口
python scripts/csqaq_api.py call --path /api/v1/current_data --method GET --query type=init --pretty

价格数据新鲜度 & 交叉验证（重要）

CSQAQ 的数据（特别是「均价」「走势」）可能存在 几天到一周的延迟，自行情页面快照不是实时的。实际成交价可能与 CSQAQ 显示价有显著偏差。

正确的价格查询流程：

  1. 发现阶段（CSQAQ）→ 搜索物品、看趋势、看历史走势
  2. 验证阶段（BUFF 实时价）→ 用 browser 打开 BUFF 商品页确认当前实际成交价

BUFF 实时价格速读法

BUFF163 商品页（如 https://buff.163.com/goods/776440）加载后，页面顶部按钮直接显示各磨损档位的当前最低售价：

┌─ Factory New ¥ 2019 ─┬─ Minimal Wear ¥ 2120 ─┬─ ★ StatTrak™ ¥ 2124.8 ─┐

直接看这几个按钮上的数字就是实时最低价，无需登录、无需翻页。

点击「Sell(N)」标签可查看所有在售列表的具体价格分布。CSQAQ 均价和 BUFF 实时价差异超过 20% 时，以 BUFF 实时价为准（BUFF 是中国 CS2 饰品最大的交易市场）。

常见陷阱

  • CSQAQ 搜索页面摘要的「均价」可能显示的是数日前数据，不是实时的
  • Steam 社区市场价格普遍高于 BUFF 价 30-50%（Steam 钱包限制导致溢价）
  • 不同平台价差很大：BUFF 价 < Waxpeer 价 < CS.MONEY 价 < Steam 市场价

注意事项

  • API Token 是敏感信息，请勿泄露或提交到代码仓库
  • 默认 Token 来源：环境变量 CSQAQ_API_TOKEN
  • 如果遇到问题，请检查 Token 是否正确设置

变更说明

v1.1.1 — 发布前认证与接口目录修复

  • 修复线上旧版本认证头，改用 CSQAQ 要求的 ApiToken
  • 同步 39 个官方接口目录

v1.1.0 — 适配 docs.csqaq.com 新格式

2026-06-04: docs.csqaq.com 升级为 Apifox SPA 架构，URL 格式从 /api-v1-current-data-get.md 改为 /api-NUMBER， 页面内容从 markdown + frontmatter 改为 HTML SPA。同步脚本已适配：

  • parse_sitemap: 移除 .md 后缀检查，所有 /api- URL 均纳入扫描
  • fetch_url: User-Agent 更新为 Chrome 128 兼容头部，超时提升到 60s
  • extract_endpoint_info: 新增 HTML 解析 fallback（提取 <title>、侧边栏 method badge、URL 展示栏 path）
  • 保留对旧格式（markdown frontmatter）和 web_extract markdown 格式的兼容
  • API 请求认证使用 ApiToken 请求头；查询参数支持重复 --query，--raw-body 按原始内容发送

许可证

MIT License

作者

ephron_ren

链接

  • CSQAQ 官网: https://csqaq.com/
  • API 文档: https://docs.csqaq.com/
  • SkillHub: https://skillhub.cn/skills/csqaq-market-lookup