Sleepwalker

面向 Agent、产品和团队的 AI 可见性与内容智能。
运行 AI 搜索检查、查看引用来源、为内容评分，并将每一个结果保存在同一个工作区中。

网站 · 应用 · 文档 · MCP · API · CLI · Cookbook

---

Sleepwalker 帮助团队了解 AI 系统如何谈论某个品牌，以及哪些内容需要调整。它结合了两个相互关联的工作流：

• AI 可见性：在 ChatGPT、Perplexity、Grok 和 Gemini 上运行提示词；捕获完整回答、引用来源、竞品和提及类型。
• 内容智能：序列化公开页面、发现需求、评估内容深度和时效性，并给出实用建议。

你可以在托管应用、公开 API、MCP 客户端或命令行中执行同样的工作。结果保持互通，因此由 Agent 发起的一次运行，之后可以在应用中查看，或从代码中查询。

本仓库是 Sleepwalker 的公开开发者界面：CLI 包、API 示例、MCP 配置说明和简短指南。托管引擎、应用源码、数据库 schema、提供商集成和计费系统均为私有。

快速开始

无需账户即可先试用 CLI。okf export 是免费且开源的。它在你的机器上运行，抓取一个页面，并将 Agent 可用的 markdown 打包文件写入本地文件夹。无需 API key，无需额度：

npx -y @sleepwalkerai/cli okf export https://www.sleepwalker.ai

一条命令即可导出两类内容：页面内容，以及 AI 爬虫所看到内容的技术 快照。可用 --content 或 --technical 缩小范围。两类内容将在下一节中介绍。

对于其他功能，请安装 CLI：

npm install -g @sleepwalkerai/cli
sleepwalker init

在 Sleepwalker 应用中创建 API key，然后运行你的第一次可见性检查：

sleepwalker auth key set sw_api_live_...
sleepwalker doctor
sleepwalker visibility run https://yourbrand.com \
  --brand YourBrand \
  --prompt "best ai visibility platform 2026" \
  --platform perplexity,openai,grok,gemini \
  --watch

## 免费 OKF 导出：内容与技​​术

一条命令即可将任何公开页面转换为 Open Knowledge Format bundle：一个包含纯 markdown 文件和 YAML frontmatter 的文件夹，任何 AI Agent 都能直接读取。OKF 是一种开放格式，发布于 Google Cloud 的 knowledge-catalog 仓库。导出完全在你的机器上运行，对所有人免费：无需账户、无需 API key、无需 credits。

sleepwalker.ai-okf/
├── index.md            navigation and okf_version
├── log.md              how and when the bundle was generated
├── home.md             the content concept
└── home-technical.md   the technical snapshot

两个概念默认都会导出。--content 只导出内容概念， --technical 只导出快照。

内容概念是页面在读者眼中的样子：干净的 markdown，包含标题、段落、列表和链接，以及 frontmatter 中的 title、description、canonical URL 和时间戳。用它把页面交给 Agent、提示词和检索管道，而无需处理 HTML 噪音。

技术快照是页面在 AI 爬虫眼中的样子。大多数 AI 爬虫不执行 JavaScript，因此快照只读取所服务的 HTML 以及响应本身：重定向链和 HTML 大小、精选 HTTP 标头、html lang 属性、meta 和 title 标签、canonical、icon 和 feed 链接、标题、hreflang、社交标签、head 脚本、每一个 JSON-LD 块、microdata 和 RDFa 摘要、链接、图片，以及页面和响应携带的 robots 指令（meta robots 和 X-Robots-Tag）。用它审计 ChatGPT、Claude、Perplexity 和 Gemini 在你的页面上实际能读取到什么。

一个示例足以说明这为何重要。客户端渲染的页面通常导出成这个样子：

## Structured data

JSON-LD: none found. AI crawlers get no schema.org data from this page as served.

一切都被如实报告，不做任何评判：导出只引用页面所提供的内容，结论留给你。重复的 title 和 canonical 被有意保留，因为它们是发现项。唯一的网络请求就是页面抓取本身。标志、上限和完整章节列表见 docs/cli.md。

想先看看数据长什么样？打开 docs/responses.md，查看序列化、提示词建议、AI Visibility、Content Intelligence 和报告查询的完整示例输出。

你可以构建什么

• AI 搜索（GEO）监控：针对特定 URL 在 ChatGPT、Perplexity、Grok 和 Gemini 上设置提示词追踪。
• Agent 工作流：让 Claude 等 MCP 客户端访问大模型回答、引用域名、竞争对手表现和内容趋势。
• 产品集成：从内部工具、客户门户、报告管道或自动化 QA 检查中调用 API。
• 内容审查：检查页面说了什么、错过了哪些趋势，以及应优先修复什么。
• 免费页面导出：用 okf export 将任何公开页面转换为 Agent 可用的 markdown。开源、本地运行、无需账户。
• 免费技术快照：每次 okf export 还会按所服务的形式捕获页面的技术层，包括 meta 标签、结构化数据、标头和 robots 指令。--technical 可单独导出它。
• 自定义工作流：将 Sleepwalker 与其他 MCP 服务组合，构建你自己的技能和自动化。

访问方式

Surface	最适合	入口
App	人工审查、credits、key 和完整结果视图	app.sleepwalker.ai
API	脚本、产品、定时任务和报告工作流	API 文档
MCP	Claude 及其他支持 MCP 的 Agent	MCP 设置
CLI	终端工作流和自动化	CLI 文档

## 在任何地方运行 Sleepwalker

命令行

sleepwalker visibility run https://yourbrand.com \
  --brand YourBrand \
  --prompt "best ai visibility platform 2026" \
  --platform perplexity,openai,grok,gemini \
  --watch

API

curl -s https://api.sleepwalker.ai/v1/visibility/runs \
  -H "Authorization: Bearer $SLEEPWALKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourbrand.com",
    "target_entity": "YourBrand",
    "prompts": ["best ai visibility platform 2026"],
    "platforms": ["perplexity","openai","grok","gemini"]
  }'

MCP

https://mcp.sleepwalker.ai/mcp

向支持 MCP 的客户端提问：Check how YourBrand appears across AI search this week.

应用

打开 app.sleepwalker.ai 使用可视化工作流、已保存的结果、额度和密钥。

开发者资源

路径	展示内容
docs/agents.md	MCP 工具目录和 Agent 工作流演示
docs/concepts.md	运行、探针、序列化、评分、额度
docs/cli.md	命令行用法，包括免费的本地 okf export
docs/cookbook.md	可运行的工作流，包括 CI 检查
docs/responses.md	Sleepwalker 主要操作的完整示例输出
mcp/server.json	远程 MCP 服务清单
mcp/tools.json	公开 MCP 工具目录、权限范围和额度行为
examples/api/curl	公开 API 操作的单次调用示例
examples/api/javascript	原生 fetch 以及一个零依赖客户端辅助工具
examples/api/python	urllib 示例以及一个小型客户端类
examples/mcp	OAuth 和 bearer token 设置说明

额度

Sleepwalker 按用量付费。读取、列表和状态轮询通常不计费。执行实际工作的操作，如可见性检查、内容评分和序列化，会消耗预付额度。okf export 是例外：它在本地运行，始终免费。详情见 docs/credits.md 和托管的计费文档。

仓库边界

本仓库有意保持精简。

此处公开	Sleepwalker 中私有
命令行、示例、设置说明、简短文档	托管引擎和应用源代码
公开 API 请求结构	MCP 服务实现
MCP 客户端连接示例	数据库 schema 和计费内部机制
产品级额度行为	提供商集成和路由

不要提交真实密钥。请使用环境变量或命令行密钥存储：

export SLEEPWALKER_API_KEY=sw_api_live_...

链接

• 网站：sleepwalker.ai
• 应用：app.sleepwalker.ai
• 文档：sleepwalker.ai/docs
• npm：@sleepwalkerai/cli
• 安全策略：SECURITY.md
• 贡献指南：CONTRIBUTING.md
• 许可证：MIT