# OpenNomos 文档

> OpenNomos 是为你自己的 agent 提供增长能力的一层（它本身不是 agent）：通过 MCP、REST 和 CLI 提供调研工具，加上服务端的项目记忆和可选的增长闭环（get_briefing、track、log_action）。它不会替你发帖或发消息，agent 不写入就不会保存任何东西。

- MCP 端点：https://mcp.opennomos.com/mcp
- REST API：https://service.opennomos.com/v1/tools
- agent 接入说明（SKILL.md）：https://service.opennomos.com/SKILL.md
- 下面每一页都有对应的 markdown 孪生页（.md 地址）。全部页面全文：https://mcp-docs.opennomos.com/zh/llms-full.txt
- English version: https://mcp-docs.opennomos.com/llms.txt

## 概览

- [OpenNomos 是什么](https://mcp-docs.opennomos.com/zh/docs/index.md)：为你自己的 agent 提供增长能力的一层，自带跨会话保留的项目记忆。

## 开始

- [快速开始](https://mcp-docs.opennomos.com/zh/docs/start/quickstart.md)：通过 MCP 接入 agent、授权，并用一次真实的工具调用验证连接。
- [核心概念](https://mcp-docs.opennomos.com/zh/docs/start/concepts.md)：项目、记忆、机会、实验、行动和简报，以及它们的关系。

## 增长闭环

- [增长闭环](https://mcp-docs.opennomos.com/zh/docs/growth-loop.md)：拉取简报，在别处干活，把发生的事回写。三个可选工具在会话之间保存跟进状态。
- [简报与排序](https://mcp-docs.opennomos.com/zh/docs/growth-loop/briefing.md)：get_briefing 返回什么、today 列表怎么排序，以及简报会改变哪些状态。
- [记忆与机会](https://mcp-docs.opennomos.com/zh/docs/growth-loop/memory-vs-opportunity.md)：人和帖子放进机会；结论、决定、草稿和规则放进记忆。
- [log_action 的默认行为](https://mcp-docs.opennomos.com/zh/docs/growth-loop/log-action.md)：省略字段时，log_action 会怎样处理阶段和下次跟进时间，精确到每种情况。
- [实验](https://mcp-docs.opennomos.com/zh/docs/growth-loop/experiments.md)：带指标、截止时间和可选停止规则的、有名字的渠道尝试。到期与决定是怎么运作的。
- [归因与 unknown](https://mcp-docs.opennomos.com/zh/docs/growth-loop/attribution.md)：短链接、结果，以及为什么来源不明的结果记为 unknown。

## 工具参考

- [工具参考](https://mcp-docs.opennomos.com/zh/docs/tools.md)：OpenNomos 的全部 21 个工具，由服务端的工具注册表生成。
- [discover_tools](https://mcp-docs.opennomos.com/zh/docs/tools/discovery/discover_tools.md)：列出所有工具、已配置的来源，以及所选来源端点及其参数 schema。
- [inspect_tool](https://mcp-docs.opennomos.com/zh/docs/tools/discovery/inspect_tool.md)：查看单个工具的完整描述和 JSON 输入 schema。
- [list_projects](https://mcp-docs.opennomos.com/zh/docs/tools/projects/list_projects.md)：列出当前工作区的项目，带记忆数量和最近更新时间。
- [create_project](https://mcp-docs.opennomos.com/zh/docs/tools/projects/create_project.md)：用调用方自定义的档案创建一个项目。
- [get_project](https://mcp-docs.opennomos.com/zh/docs/tools/projects/get_project.md)：读取项目卡片和最近的记忆。
- [update_project](https://mcp-docs.opennomos.com/zh/docs/tools/projects/update_project.md)：更新项目名称，并对调用方自定义的档案字段做浅合并。
- [memory_add](https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_add.md)：显式保存一条记忆。
- [memory_update](https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_update.md)：按 id 只更新给出的记忆字段。
- [memory_search](https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_search.md)：搜索这个项目的记忆。
- [memory_forget](https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_forget.md)：按 id 忘掉一条记忆。
- [get_briefing](https://mcp-docs.opennomos.com/zh/docs/tools/growth/get_briefing.md)：可选；当用户让你继续某个项目的增长工作时，是个很好的第一次调用。
- [track](https://mcp-docs.opennomos.com/zh/docs/tools/growth/track.md)：登记或更新要跟进的东西：机会（值得行动的帖子、人、社区或合作方）、实验（带截止时间和可选停止规则的渠道尝试）和短链接（用于点击归因）。
- [log_action](https://mcp-docs.opennomos.com/zh/docs/tools/growth/log_action.md)：记录你（或用户）刚在某个增长条目上做过或观察到的事：发生了什么（一句话就够）、只有确知变了才填的新阶段、何时跟进，以及任何结果。
- [search_signals](https://mcp-docs.opennomos.com/zh/docs/tools/research/search_signals.md)：用调用方的查询搜索公开的讨论和网页。
- [fetch_url](https://mcp-docs.opennomos.com/zh/docs/tools/research/fetch_url.md)：把 1–10 个 URL 抓取为干净的 markdown。
- [seo_research](https://mcp-docs.opennomos.com/zh/docs/tools/research/seo_research.md)：SEO 数据。
- [ai_visibility](https://mcp-docs.opennomos.com/zh/docs/tools/research/ai_visibility.md)：用给定的问题去查询 ChatGPT 公开的、未登录的搜索界面。
- [collect_feedback](https://mcp-docs.opennomos.com/zh/docs/tools/research/collect_feedback.md)：读取评价或评论，返回原始数据。
- [creator_lookup](https://mcp-docs.opennomos.com/zh/docs/tools/research/creator_lookup.md)：查找创作者并评估体量。
- [competitor_intel](https://mcp-docs.opennomos.com/zh/docs/tools/research/competitor_intel.md)：竞品数据。
- [news_search](https://mcp-docs.opennomos.com/zh/docs/tools/research/news_search.md)：按查询读取新闻文章，或读取当前的 Hacker News / GitHub 趋势条目（无需查询）。

## 参考

- [数据源与限制](https://mcp-docs.opennomos.com/zh/docs/reference/data-sources.md)：search_signals 和其他调研工具读取哪些来源、返回什么，以及适用的限制。
- [定价与限额](https://mcp-docs.opennomos.com/zh/docs/reference/pricing-and-limits.md)：工具包、每月上游成本上限，以及目前哪些免费。价格在计费配置好之前仍是 TODO。
- [错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)：两种失败形态、reason 和 action 字段，以及 agent 在每种情况下该怎么做。
- [REST 与 CLI](https://mcp-docs.opennomos.com/zh/docs/reference/rest-and-cli.md)：不用 MCP 直接调用工具：认证、项目选择，以及现有的端点。
- [隐私与数据处理](https://mcp-docs.opennomos.com/zh/docs/reference/privacy.md)：OpenNomos 存什么、不存什么，以及哪些上游服务商会看到你的查询。基于服务代码的草稿。
- [服务条款（草稿）](https://mcp-docs.opennomos.com/zh/docs/reference/terms.md)：占位页。这些条款只是草稿，尚未生效。