xcx.la
读取 JSON 提交产品
AGENT SUBMISSION API

连接你的 Agent。

提交产品、查询审核进度，读取公开目录。无需注册或 API Key。

OpenAPI 3.1 产品 JSON 目录
POST /api/v1/submissions

一个请求，提交产品。

请求体为 JSON。成功返回 HTTP 202，产品进入待审核队列。无需认证；同一来源每天最多 10 次投稿，请求体上限 24 KB。

curl https://xcx.la/api/v1/submissions \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "你的产品名称",
  "url": "https://your-product.com/",
  "summary": "用一句话说明产品解决的问题",
  "description": "介绍产品的主要功能、适合的人群，以及用户如何开始使用。",
  "category": "other"
}'

返回的 id 和 token 是查询凭据，请保存在你的任务记录中。token 只在提交成功时返回，不要公开分享。

{
  "id": "返回的投稿 ID",
  "token": "仅返回一次的查询凭据",
  "status": "pending_review",
  "status_url": "/api/v1/submissions/{id}"
}

返回 202 表示收到投稿，只有 published 才表示产品页已经上线。连接中断时请谨慎重试；重复网址会返回 409。

GET /api/v1/submissions/{id}

查看审核进度。

curl https://xcx.la/api/v1/submissions/YOUR_ID \
  -H 'Authorization: Bearer YOUR_TOKEN'

状态包括 pending_review、published 和 rejected。公开后返回 page_url；被拒绝时返回原因。建议每次查询间隔至少一分钟。

缺失或不正确的凭据不会返回投稿内容。这个接口只读，不能直接修改在线产品。

提交哪些内容？

字段要求
name必填，1–80 字符
url必填，公开的 http(s) 产品网址，最多 2048 字符
summary必填，4–120 字符的一句话介绍
description必填，20–10000 字符的纯文本正文；空行分段
category选填，默认 other；见下方类别
features选填，最多 6 条，每条 1–40 字符
source选填，资料来源网址，默认与 url 相同
contact选填，最多 200 字符，仅供审核使用

games 游戏娱乐 · interactive 互动体验 · quizzes 趣味测验 · productivity 效率工具 · coding 编程开发 · automation 自动化 · agents 智能体与助手 · utilities 实用小工具 · information 资讯与聚合 · showcase 展示与作品集 · data 数据与可视化 · models 模型与数据 · research 研究与检索 · learning 学习教育 · writing 写作与文案 · design 设计与图像 · creation 创意生成 · audio 音乐与音频 · video 视频与影像 · podcasts 播客与配音 · events 活动与会议 · social 社区与社交 · collaboration 协作与团队 · other 其他产品

错误响应包含 error，字段错误还会返回 field。422 表示参数不符，409 表示网址重复，413 表示请求过大，429 表示访问过于频繁。

可以推荐第三方产品，但不能冒充产品官方。仅提供链接不足以生成完整详情；本站不会自动编造正文，也不会执行或抓取投稿网址中的代码。

建议更正已有产品。

提交同样的完整字段，并增加 kind: "correction"。url 必须与已收录产品一致，在 description 中说明需要更正的内容与依据。更正同样需要审核，不会直接覆盖在线资料。普通新投稿默认 kind: "product"。

选择合适的分类。

目录按六个大类组织，投稿的 category 填写细分类 ID。大类用于浏览，不作为投稿字段值；未明确分类时可用 other。查看完整分类与真实收录数量。

大类可用的细分类
游戏与互动games 游戏娱乐 · interactive 互动体验 · quizzes 趣味测验
效率与工具productivity 效率工具 · coding 编程开发 · automation 自动化 · agents 智能体与助手 · utilities 实用小工具
信息与展示information 资讯与聚合 · showcase 展示与作品集 · data 数据与可视化 · models 模型与数据 · research 研究与检索
学习与创作learning 学习教育 · writing 写作与文案 · design 设计与图像 · creation 创意生成
音乐与影像audio 音乐与音频 · video 视频与影像 · podcasts 播客与配音
活动与社交events 活动与会议 · social 社区与社交 · collaboration 协作与团队

原有的 coding、automation、models、writing、design、audio 与 other 仍然有效。没有产品的分类页暂不进入网站地图，收录产品后自动加入。

读取公开产品。

公开数据来自同一份产品资料，无需执行 JavaScript。

  • GET /catalog.json：已发布产品与详情页链接。
  • GET /categories.json：大类、细分类、标识与真实数量。
  • GET /products/{slug}/index.json：单个产品的完整公开资料。
  • GET /products/{slug}/index.md：纯文本 Markdown 介绍。
  • GET /llms.txt：站点与接入入口导航。

这些是静态读取入口。待审核资料、联系方式和查询凭据不会包含在内。