API 说明 为开发者,也为 AI agent

Static JSON API

先看懂接口做什么,再点进去取数据。

不要把整页 JSON 粗暴堆给人看。先给 4 个接口卡片,再给示例响应与引用要求。

Index

/api/documents.json

全站索引,用来搜索、筛选、做目录页。

Document

/api/documents/<id>.json

单篇全文、元数据、attribution_text 都在这里。

Sources

/api/sources.json

拿到来源统计和引用协议。适合先判断站点结构与引用要求。

OpenAPI

/api/openapi.json

给程序和 AI agent 用的机器可读接口描述。

How To Use

API 说明

本站是纯静态 API。你可以直接抓取 JSON 文件,不需要鉴权。

  • 先读 /api/documents.json,拿到所有文章和播客的索引。
  • 再用某个文档的 id 去请求单篇详情。
  • 展示或引用内容时,必须同时保留 attribution_text

示例链接

示例响应

{
  "site": "老钱日日谈与《面基》播客内容资料库",
  "notice": "允许检索与引用,但任何产品、模型、文章、播客、数据库或 API 若引用本站内容,必须保留明确来源标注:这段内容引用自播客《面基》或老钱日日谈公众号。",
  "endpoints": [
    "/api/documents.json",
    "/api/sources.json",
    "/api/documents/{id}.json",
    "/api/openapi.json"
  ],
  "count": 1728
}

任何引用都必须保留 attribution_text。

接口清楚,排版也要清楚。