complydir

complydir

一个合规帮助目录，可供你的 Agent 搜索。complydir 封装了一个精选服务目录，涵盖 ISO 27001、SOC 2、DORA 及相关框架——包括咨询公司、审计机构和软件——并以单个目录快照的形式发布。无需账户或 API 密钥：这些工具会获取快照，在本地回答相关问题，还可以提交新的免费条目以供审核。

由于搜索针对的是快照，而非远程搜索调用，因此筛选规则精确且可预测。标签筛选不会进行子字符串匹配：搜索地区 “Germany” 会返回带有 Germany 标签的服务；搜索两个框架时，只会返回同时带有这两个标签的服务。

工具

• search_services — 多条件目录搜索。 所有参数均为可选，但至少需要一个：query（用于为筛选结果排序的自由文本）、framework（单个框架）、frameworks（多个框架，按 AND 条件组合）、region、industry、service_type 和 limit （1–25，默认为 10）。标签匹配不区分大小写，且要求完全匹配；service_type 为 “Consulting” 时，也会匹配带有 “Consultants” 标签的服务。例如，frameworks 为 ["ISO 27001", "DORA"]，地区为 “Germany”，且 service_type 为 “Consulting” 时，会返回覆盖这两个框架并提供咨询服务的德国服务。
• check_if_listed — 检查某家公司是否在目录中。需要传入 company_name（例如 “Scrut Automation”）；如果该公司已列入目录，则返回匹配的记录。
• get_service_details — 按必需参数 service_name 获取某项服务的完整目录记录（例如 “Compleye”）。
• list_categories — 获取目录某个维度中的不同值及其数量。dimension 可设为 frameworks、regions、industries、service_types 或 problems；省略该参数则一次性获取所有维度。
• submit_listing — 提交免费条目以供审核（唯一的写入工具）。必需参数：name、url（http 或 https）、email（联系地址，不会公开显示）和 brief_summary（10–300 个字符）。可选参数：description、linkedin、service_type、region_covered 和 compliance_framework_expertise。调用前，请先向用户确认名称、网站、联系邮箱和一句话摘要——排队待审核的条目会进入与免费网页表单相同的审核队列，不会立即上线。

工作原理

读取工具会从 https://ismsdirectory.com/api/tools.json 获取公开快照，并在内存中对其进行处理；submit_listing 则会向 https://ismsdirectory.com/api/submit 发送请求。两者都通过一个可注入的 fetch 函数运行，测试套件正是通过该函数，使用小型手工构建的快照进行全面测试，不会发起实时请求。

其中两种结构标注为重构形式，因为已发布材料只固定了字段，而未固定记录布局：服务记录中，除服务名称以及框架、地区、行业和服务类型标签之外的字段；以及工具的输出对象。输出围绕固定字段构建——服务名称、标签和匹配的筛选条件。

错误信息清晰易懂：上游返回非 2xx 响应时，错误为 complydir error: HTTP <status>；无法访问上游时，错误为 complydir unreachable；快照无法解析为记录列表时，错误为 complydir snapshot invalid。

CLI

每个工具都是一个子命令，接收一个 JSON 参数字符串：

npx @reneturcios/complydir search_services '{"frameworks":["ISO 27001","DORA"],"region":"Germany","service_type":"Consulting"}'
npx @reneturcios/complydir check_if_listed '{"company_name":"Scrut Automation"}'
npx @reneturcios/complydir get_service_details '{"service_name":"Compleye"}'
npx @reneturcios/complydir list_categories '{"dimension":"frameworks"}'
npx @reneturcios/complydir submit_listing '{"name":"Acme Compliance","url":"https://acme.example","email":"[email protected]","brief_summary":"ISO 27001 consulting for SaaS"}'
npx @reneturcios/complydir --version

退出码：成功时为 0，运行时错误时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/complydir mcp

MCP 客户端配置：

{
  "mcpServers": {
    "complydir": {
      "command": "npx",
      "args": ["-y", "@reneturcios/complydir", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/complydir
docker run --rm ghcr.io/cloudcorprecords/complydir list_categories '{"dimension":"regions"}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios