资源遍历MCP-通用Web密钥
愿景： 将静态指针转换为实时认知门户。
开发商： Kavia Shirkoohi(shirkoohi.com)
它的作用
资源遍历MCP在经过身份验证的网络上为您的AI提供“眼睛”和“密钥”。在现代工作流程中， 塔娜是骷髅 （结构）， 谷歌是肌肉 （数据），这个引擎是 结缔组织 这允许AI在它们之间流畅地移动。
它不依赖脆弱或受限的API，而是使用 原生Chromium无头架构 继承您现有的浏览器会话。如果你能在浏览器中看到它，你的人工智能现在可以作为一流的观察者“穿越”它。
核心突破
- 统一身份验证层： AI通过本地“主配置文件”（.auth/文件夹）继承您的权限。不需要API密钥或开发人员帐户。
- 原生铬隐形： 用途
--headless=new通过硬件锁定的操作系统加密（macOS Keychain/Windows DPAPI），CloudFlare和高级机器人检测无法检测到。 - 时间导航： SPA（单页应用程序）的专门滚动逻辑，可以捕获完整的对话历史，而不仅仅是可见的屏幕。
- “大满贯”证明： 在高摩擦“硬目标”中取得成功，包括 Slack、Discord、Linear、Jira和谷歌工作区.
- 隐式上下文门户： 旨在治疗 *任何* Tana中的URL作为AI内存的实时扩展。
先决条件
开始之前，请确保在本地计算机上安装了以下内容：
- 面包： 快速的JavaScript运行时(
curl -fsSL https://bun.sh/install | bash). - 谷歌Chrome浏览器： 本机无头发动机所需。
快速开始
1.安装依赖项
bun install2.通用认证密钥（一次性登录）
在几秒钟内为您的AI解锁任何网站：
bun run auth [URL]*例子：* bun run auth https://chatgpt.com\ 在打开的窗口中手动登录，然后关闭浏览器。您的会话现在已硬件锁定到本地计算机，以供AI重用。
3.添加到Tana/Claude/Cursor
将您的MCP客户指向项目的 index.ts 文件。
工具
| 工具 | 说明 |
|---|---|
traverse_resource | 从以下位置获取内容 *任何* 经过身份验证的URL（Gemini、ChatGPT、Slack等） |
check_auth | 验证本地“主配置文件”会话是否存在 |
支持的门户网站（已验证）
| 服务 | 能力 |
|---|---|
| AI聊天 | ✅ Gemini、ChatGPT、Grok（完整历史滚动） |
| 社区 | ✅ 不一致、松弛（档案、线程、实时上下文） |
| 知识/杂项 | ✅ GitHub（Repos），🧪 Raindrop.io（实验） |
| 生产力 | ✅ 谷歌文档、NotebookLM |
🏗️ 可扩展性：模块化提取框架
该项目被设计为 模块化生态系统。您可以通过向添加“站点适配器”轻松添加对任何新站点的支持 lib/extractors.ts 图书馆。
- 即插即用： 添加新门户只需要几行代码。
- 人工智能驱动的维护： 包括
SYSTEM_PROMPTS.md包含a 自愈提取策略，允许您的AI代理自主地对损坏的选择器进行故障排除，并向框架提出代码更新建议。 - 通用回退： 如果不存在专用适配器，该工具将使用智能适配器 通用废料 以确保没有链接是死胡同。
🔒 隐私和安全
- 本地优先： 您的凭据和Cookie永远不会离开您的计算机。
- 零云： 没有第三方服务器。数据直接从网络流向您的本地AI。
- 一致意见： AI只会进入您通过以下方式明确解锁的门户
auth工具。
⚠️ 潜在限制
虽然资源遍历MCP非常先进，但用户应该注意以下“边缘情况”：
- 阴影DOM和画布： 一些应用程序（特别是 谷歌文件)不要将它们的文本存储在标准DOM中。它们在Canvas元素上“绘制”文本，使其对标准文本提取器不可见。
- 专业提示： 为了获得使用Google Docs的最佳体验，我们建议通过专用的基于API的MCP服务器连接它们。将资源遍历MCP用于“难以访问”的门户，如Gemini、ChatGPT和Slack，这些门户的官方API有限或不存在。
- 动态会话持久性： 某些服务（尤其是 Raindrop.io)采用独特的会话锁定机制，即使在主配置文件中，偶尔也需要主动用户交互。在我们改进持久性切换时，这些目前被归类为“实验性”。
- 易碎选择器： Web应用程序经常更新其布局。如果Gemini或Slack等服务更改了其内部代码，则专门的提取器可能会返回不完整的结果，直到更新为止。
- 未来路线图： 我们正在研究一种“自愈”更新系统，该系统允许人工智能在检测到破损时动态识别新的选择器。
- 会话到期时间： Cookie最终会过期。如果AI碰到登录墙，它会主动通知您运行指令
bun run auth [URL]刷新您的“主配置文件” - 冷启动延迟（会话水合作用）： 当首次启动重SPA的遍历时，例如 Discord 的中文翻译是“不和谐”或“纷争”。 或 Slack，存在固有的“冷启动”延迟（30-60秒）。当Native Chromium Headless引擎初始化硬件锁定的操作系统配置文件、导航URL并等待应用程序的繁重JavaScript层（React/Electron）水合DOM时，就会发生这种情况。
- AI代理的专业提示： 代理应在“启动浏览器并等待会话水合”时主动通知用户，以管理此初始化阶段的期望。
- 临时加载： 大型历史记录（尤其是在Slack或长时间聊天中）需要大量滚动。AI被配置为“回溯”历史，但非常大的线程可能需要几秒钟才能完全遍历。
⚠️ 免责声明
该工具旨在用于个人研究和知识管理。用户有责任遵守他们浏览的网站的服务条款。
______________________________________________________________________