# 门道

> 做一件事之前，先看做过的人怎么做。门道是一个中文的最佳实践库：不是资讯日报，也不是教程模板，只按门类和实操问题收录实践者自己讲做法的帖子、视频和文章。

收录规则是第一手：作者自己做过，有具体的做法、步骤、结果或踩坑，能回答一个实操问题，不是广告。转述、产品公告、纯观点和推广都不收。采集和排序是固定程序，判断由模型完成，所以会有错收和漏收；每一条都能回到原文核对。库只增不减，只有下架才移出。

额度：不登录时每道题只能取前 10 条，接口会同时告诉你总数。登录或使用 Agent 密钥后可以取全部。

版权：内容属于原作者和原发布方。中文原文这里只有入选理由和短摘录；英文内容附 AI 译文，以原文为准。引用时必须链接原文，也就是每一条的 `url` 字段。

## 阅读

- [全部门类和问题](https://mendaoai.com/categories)：每个门类是一条路线，每一步下面是实操问题
- [整个库](https://mendaoai.com/library)：按月份、门类、做法类型和平台翻看
- [我们怎么选和真实记录](https://mendaoai.com/agents)：收录标准、谁来判断、看过和丢弃了多少
- [完整目录](https://mendaoai.com/llms-full.txt)：每个门类、每道题、每条免费做法的标题、入选理由、作者、原文和本站地址，一个文件读完
- 单条做法的地址是 `/p/{门类}/{编号}`，加 `.md`（或请求头 `Accept: text/markdown`）得到 Markdown 版本；实践者的地址是 `/people/{平台}~{handle}`

## 接口

只读，返回 JSON。未鉴权只见每题前 10 条；要全部内容时用 `Authorization: Bearer md_...`。

- [问题列表](https://mendaoai.com/api/v1/mendao/library/questions)：门类、步骤、问题和条数
- [做法列表](https://mendaoai.com/api/v1/mendao/library/posts)：参数 `industry question platform author tag since until q sort(top|new|added) page size around`
- [单条](https://mendaoai.com/api/v1/mendao/library/post)：参数 `id`，可加 `industry`；锁定内容未鉴权返回 401
- [每天条数](https://mendaoai.com/api/v1/mendao/library/calendar)：参数 `industry question`
- `/api/v1/mendao/library/people/{平台}/{handle}`：一位实践者和他讲的问题
- `/api/v1/mendao/library/changes`：增量同步新增和下架，要鉴权

## 接入

- [给 Agent 读的说明](https://mendaoai.com/api/v1/mendao/agent)：怎么查、额度和引用规则
- [Agent Skill](https://mendaoai.com/skill/README.md)：安装说明
- 远程 MCP：`https://mendaoai.com/api/v1/mendao/mcp`
- [RSS](https://mendaoai.com/api/v1/mendao/feed.xml)：可加 `industry` `question`
- [OpenAPI](https://mendaoai.com/api/v1/mendao/openapi.json)

## 命令行

- [接入 Agent](https://mendaoai.com/connect)：安装 `uv tool install https://mendaoai.com/cli/mendao_cli-1.1.0-py3-none-any.whl`，用 `mendao commands` 看全部命令，输出都是 JSON

## 可选

- [站点地图](https://mendaoai.com/sitemap.xml)
- [隐私与下架](https://mendaoai.com/privacy)