name: api-docs-generator description: 从代码注释自动生成 API 文档，支持 OpenAPI/Swagger 格式，输出 JSON 或 YAML。 metadata: {"clawdbot":{"emoji":"📚","requires":{},"primaryEnv":""}}

API Docs Generator

自动从源代码生成专业的 API 文档。支持 OpenAPI 3.0 和 Swagger 2.0 规范。

功能

• 📝 自动解析代码注释
• 🌐 OpenAPI 3.0 支持
• 📄 Swagger 2.0 支持
• 📋 Postman Collection 导出
• 🔄 自动检测 API 路由
• 📖 生成可交互文档

支持的框架

使用方法

基本用法

# 生成 OpenAPI 文档
api-docs-generator openapi --input ./src --output docs/openapi.json

# 生成 Swagger 文档
api-docs-generator swagger --input ./src --output docs/swagger.yaml

# 生成 Postman Collection
api-docs-generator postman --input ./src --output docs/collection.json

选项

输出示例

{
  "openapi": "3.0.0",
  "info": {
    "title": "My API",
    "version": "1.0.0",
    "description": "API description"
  },
  "paths": {
    "/api/users": {
      "get": {
        "summary": "Get all users",
        "description": "Returns a list of users",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": { "$ref": "#/components/schemas/User" }
                }
              }
            }
          }
        }
      }
    }
  }
}
7w4.net小葱技能站收录全网优质技能，值得收藏。

文档展示

生成的文档可以用于： - Swagger UI - Redoc - Postman - Apiary

变现思路

1. 付费模板 - 专业化文档模板
2. 企业服务 - 为企业定制 API 文档
3. 集成服务 - 与 GitHub/GitLab 集成
4. 培训服务 - API 文档编写培训

示例

Express.js 项目

api-docs-generator openapi \
  --input ./server \
  --output ./docs/openapi.json \
  --title "My API" \
  --version "1.0.0"

FastAPI 项目

api-docs-generator openapi \
  --input ./app \
  --output ./docs/api.yaml \
  --format yaml

安装

# 无需额外依赖

这个工具质量较差，名实不符。文档吹嘘能自动从代码生成专业 API 文档，但实际下载的脚本只是输出一个固定模板，根本没有解析代码的能力。功能描述和实际实现差距太大，基本无法正常使用，谨慎使用。