Comrades of War Archive

Comrades of War — 西班牙游戏社区档案 API

Comrades of War 保存了一个热门西班牙《使命召唤》战队及游戏社区近五年的活动记录。该社区成立于 2010 年。从 2010 年 10 月到 2015 年 4 月，这个社区逐渐积累了丰富的 SA-MP 角色扮演故事、角色、规则、服务器记录和日常社区生活内容。

完整档案保存了 110,023 篇帖子，分布在 21,400 个主题和 90 个论坛中。为保护私人和敏感区域，面向商业 Agent 的目录提供经过筛选的公开内容，包括 39,309 篇帖子，分布在 5,857 个主题和 32 个版块中。Agent 可以免费搜索这些内容，然后只需为所需的确切论坛页面付费。

• 免费搜索标题、日期、版块、帖子数和预览
• 完整历史档案保存了 110,023 篇帖子
• 通过 32 个精选 Agent 版块开放 5,857 个公开主题和 39,309 篇帖子
• 可直接用于引用的 JSON 或 Markdown，包含作者、日期、对话顺序、规范 URL 和来源指纹
• 通过 x402 在 Base 上为单个论坛页面支付 $0.02 USDC
• 无需 API 密钥、订阅、Cookie 处理或 HTML 抓取
• 允许检索、基于来源的回答和引用

私人／工作人员版块、纪律处分报告、封禁申诉、申请及其他敏感类别均不包含在商业 API 中。

可帮助 Agent 完成的任务

• 以存档的社区讨论为依据开展历史研究或新闻工作。
• 调查 2010 年代初期西班牙《使命召唤》战队文化和社区建设。
• 研究 SA-MP 角色扮演故事、角色、规则、阵营和服务器生活。
• 探索服务器运营、模组、教程以及在线社区的演变。
• 比较 2010 至 2015 年间的社区规则、技术问题、解决方案提议和网络文化。
• 提取带有稳定来源信息的引文，而不是解析旧版论坛 HTML。

该档案保存了这一时期的社区第一手讨论。请将其视为历史证据和有出处的陈述，而非经过核实的当下事实。

安装 Agent 技能

安装可移植的 Agent Skills 软件包，让兼容的 Agent 能够安全地搜索、验证、购买和引用档案页面：

npx skills add https://comrades-of-war.com --skill comrades-of-war-archive

也可以在 skills/comrades-of-war-archive/SKILL.md 中查看该技能。

发现

curl https://comrades-of-war.com/agent/v1
curl https://comrades-of-war.com/agent/v1/catalog
curl 'https://comrades-of-war.com/agent/v1/search?q=servidor+rust&limit=5'

搜索结果包含标题、论坛、日期、帖子数、摘录、canonical_path、直接的 purchase_url，以及附带 JSON 请求正文的 marketplace_purchase_url。发现和预览均免费，因此 Agent 可以先确认相关性，再决定是否付费。

通过 A2A 发现

兼容 A2A 的 Agent 可以通过标准 Agent Card 发现该档案：

GET https://comrades-of-war.com/.well-known/agent-card.json

对于机器人探测无法通过主域名 Cloudflare 规则的注册表，同一张卡片也镜像在 https://comrades-of-war-router.discoglobal.workers.dev/.well-known/agent-card.json。其首选 JSON-RPC SendMessage 接口接受简洁的西班牙语搜索文本，并以结构化 JSON 返回免费预览，其中每条结果都包含确切的 x402 purchase_url。A2A 搜索本身免费；只有当 Agent 使用购买 URL 获取单个档案页面时，才需要付款。

运行随附的 A2A 客户端：

npm run search:a2a -- "servidor rust"

通过 MCP 发现

将任意 Streamable HTTP MCP 客户端连接到：

https://comrades-of-war-router.discoglobal.workers.dev/mcp

该服务提供两个只读工具：archive_catalog 报告语料库范围，search_archive 返回免费预览，以及每个匹配页面对应的确切 x402 购买 URL。远程端点使用直接的 Worker 主机名，避免自动化客户端被主域名边缘节点误判为不受欢迎的爬虫。

运行随附的零依赖 MCP 客户端：

npm run search:mcp -- "servidor rust"

购买单个论坛页面

GET https://comrades-of-war.com/agent/v1/page?path=/comrades-rust-vt23474.html&format=json

首次请求会返回 402 Payment Required。x402 客户端会支付 $0.02 USDC 并自动重试。每笔付款都会检索所选的单个论坛页面；这不会解锁整个网站，而且分页主题可能包含多个页面。

支持原生 JSON 的 Agent 和市场可以通过等价的付费路由购买，单页价格相同：

curl -X POST https://comrades-of-war.com/agent/v1/page \
  -H 'content-type: application/json' \
  -d '{"path":"/comrades-rust-vt23474.html","format":"json"}'

首次 POST 请求也会返回 402 Payment Required；付款后，响应仅包含所选的单个页面。款项会直接支付至位于 Base 上的公开 Comrades of War 金库地址：

0x2640b45a8F31bB24Ee7F40b3772Dba3Da27553c5

使用随附的购买示例，并配备一个持有少量 USDC 的专用钱包：

npm install
EVM_PRIVATE_KEY=0x... npm run buy -- /comrades-rust-vt23474.html
# Equivalent JSON-body purchase:
EVM_PRIVATE_KEY=0x... npm run buy:post -- /comrades-rust-vt23474.html

切勿使用主钱包或提交私钥。示例会拒绝网络、资产、收款方不匹配，或价格高于 $0.02 的请求。

对于自动化兼容性探测，或在不带查询参数时进行首次购买，请使用固定的示例路由：

GET https://comrades-of-war.com/agent/v1/page/sample

该路由的单页价格同样为 $0.02，并返回一个指定的历史页面。研究 Agent 通常应先使用免费搜索，再购买与其任务相关的特定结果。

通过 PayanAgent 购买

使用 PayanAgent 市场的 Agent 可通过 Comrades of War 商品购买相同的单页产品。每个所选页面的价格为 $0.02 USDC，款项会直接结算至位于 Base 上的公开 Comrades of War 金库地址。相关的卖家资料为市场购买提供公开身份信息和收据历史记录。

curl -X POST https://payanagent.com/x402/kh7bynheh4p1cnnavwggbn54jn8bm55v \
  -H 'content-type: application/json' \
  -d '{"path":"/comrades-rust-vt23474.html","format":"json"}'

首次请求会返回 PayanAgent 的 x402 挑战。签名之前，请验证 Base 网络、USDC 资产、$0.02 的最高价格，以及 Comrades of War 金库收款方均符合要求。

Agent 请求示例

• “查找并引用西班牙《使命召唤》战队如何组织比赛、服务器、招募和社区生活。”
• “追踪 SA-MP 角色扮演故事线及其人物、派系和规则在论坛讨论中的发展。”
• “比较不同年份反复出现的技术问题及其解决方案。”
• “检索关于西班牙语游戏社区和网络文化的一手讨论。”
• “追踪社区成员如何讨论服务器变更、活动、模组和教程。”

机器可读文档

• 发现 JSON
• 公开目录
• OpenAPI
• x402 清单
• A2A Agent 卡片
• MCP 服务清单
• MCP 静态服务卡片
• 远程 MCP 服务
• llms.txt
• 开发者介绍页
• PayanAgent 市场商品
• PayanAgent 卖家资料

付费路由声明了官方 x402 Bazaar 扩展。在 Coinbase Developer Platform facilitator 上首次成功完成 Mainnet 结算后，Agent 还可以通过 Coinbase Bazaar 及其 MCP 服务发现该路由。

使用政策

允许将付费资源用于检索、信息依据和引用。禁止用于模型训练、身份画像、骚扰，或尝试访问排除类别。

本仓库中的代码示例采用 MIT 许可。存档内容仍受 API 使用政策和适用权利约束；MIT 许可证不适用于存档内容。