browser-ai-cli 0.1.0__py3-none-any.whl

browser_ai_cli-0.1.0.data/data/browser_ai_examples/ai_sites.example.json

@@ -0,0 +1,188 @@
+{
+  "_说明": "AI站点配置文件 - 复制本文件为 ai_sites.json 并按需修改。所有站点路径相对本目录的 profiles/ 下。",
+  "_documentation": "AI site configuration. Copy this file to ai_sites.json and edit as needed. Profile directories live under ./profiles/<site_name>/.",
+  "_字段说明 / field reference": {
+    "name": "站点唯一标识（英文，用于profile目录名） / unique site ID (English, used as profile directory name)",
+    "display_name": "显示名称（中文/任意） / display name shown to humans",
+    "url": "站点入口URL / entry URL",
+    "login_url": "登录页URL / login URL (used for first-time login)",
+    "login_hint": "登录提示 / hint shown to the user during login",
+    "capabilities": "能力列表 / capability list: search=搜索, summarize=总结, chat=对话, file_upload=文件上传, video_ai=视频AI理解",
+    "selectors": {
+      "input": "输入框CSS选择器 / input box CSS selector",
+      "submit": "提交按钮CSS选择器 / submit button CSS selector",
+      "response": "响应内容容器CSS选择器 / response container CSS selector"
+    },
+    "special": "特殊处理标记 / special handler tag",
+    "enabled": "是否启用 / enabled",
+    "preferred_engine": "首选引擎 / preferred engine: chromium(登录态持久化 / persistent profile) / camoufox(反检测强 / strong anti-detect)",
+    "cookie_domains": "用于Firefox批量导入时匹配的域名列表 / domains used to match Firefox cookies during batch import"
+  },
+  "_添加新站点示例 / example new site": {
+    "name": "my_ai",
+    "display_name": "我的AI",
+    "url": "https://my-ai.com/",
+    "login_url": "https://my-ai.com/login",
+    "login_hint": "用手机号登录 / login with phone number",
+    "capabilities": ["chat"],
+    "selectors": {
+      "input": "textarea",
+      "submit": "button[type='submit']",
+      "response": "div.answer"
+    },
+    "special": null,
+    "enabled": true
+  },
+  "sites": [
+    {
+      "name": "yuanbao",
+      "display_name": "腾讯元宝 / Tencent Yuanbao",
+      "url": "https://yuanbao.tencent.com/chat",
+      "login_url": "https://yuanbao.tencent.com/",
+      "login_hint": "点击右上角登录，用微信或QQ扫码登录 / login with WeChat or QQ",
+      "capabilities": ["search", "summarize", "chat", "file_upload", "weixin_bypass"],
+      "selectors": {
+        "input": "textarea[placeholder*='输入'], textarea[placeholder*='问'], div[contenteditable='true']",
+        "submit": "button[type='submit'], button[aria-label*='发送'], button[class*='send']",
+        "response": "div[class*='answer'], div[class*='message'], div[class*='content']"
+      },
+      "special": "weixin_bypass",
+      "enabled": true,
+      "preferred_engine": "chromium",
+      "cookie_domains": [".tencent.com", "yuanbao.tencent.com"]
+    },
+    {
+      "name": "kimi",
+      "display_name": "Kimi（月之暗面 / Moonshot AI）",
+      "url": "https://kimi.moonshot.cn/chat",
+      "login_url": "https://kimi.moonshot.cn/",
+      "login_hint": "点击登录，可用手机号或微信扫码 / login with phone or WeChat",
+      "capabilities": ["search", "summarize", "chat", "file_upload"],
+      "selectors": {
+        "input": "textarea[placeholder*='输入'], textarea.editor",
+        "submit": "button[type='submit'], button[aria-label*='发送'], div[class*='send-button']",
+        "response": "div[class*='chat-content'], div[class*='answer'], section[class*='message']"
+      },
+      "special": "long_text",
+      "enabled": true,
+      "preferred_engine": "chromium",
+      "cookie_domains": ["kimi.moonshot.cn", ".moonshot.cn"]
+    },
+    {
+      "name": "tongyi",
+      "display_name": "通义千问 / Tongyi Qianwen",
+      "url": "https://tongyi.aliyun.com/qianwen",
+      "login_url": "https://tongyi.aliyun.com/",
+      "login_hint": "右上角登录，用阿里账号或支付宝扫码 / login with Aliyun or Alipay",
+      "capabilities": ["search", "summarize", "chat", "file_upload"],
+      "selectors": {
+        "input": "textarea[placeholder*='输入'], textarea[id*='input'], div[contenteditable='true']",
+        "submit": "button[type='submit'], button[aria-label*='发送'], button[class*='send']",
+        "response": "div[class*='answer'], div[class*='message-content'], div[class*='bubble']"
+      },
+      "special": null,
+      "enabled": true,
+      "preferred_engine": "chromium",
+      "cookie_domains": ["tongyi.aliyun.com", ".aliyun.com"]
+    },
+    {
+      "name": "zhida",
+      "display_name": "知乎直答 / Zhida AI",
+      "url": "https://zhida.ai/",
+      "login_url": "https://zhida.ai/",
+      "login_hint": "用知乎账号登录 / login with Zhihu account",
+      "capabilities": ["search", "summarize", "chat"],
+      "selectors": {
+        "input": "textarea[placeholder*='输入'], textarea[placeholder*='问'], input[type='text']",
+        "submit": "button[type='submit'], button[aria-label*='搜索'], button[class*='send']",
+        "response": "div[class*='answer'], div[class*='result'], div[class*='content']"
+      },
+      "special": "knowledge_qa",
+      "enabled": true,
+      "preferred_engine": "chromium",
+      "cookie_domains": ["zhida.ai", ".zhida.ai"]
+    },
+    {
+      "name": "bili_ai",
+      "display_name": "B站AI搜索 / Bilibili AI Search",
+      "url": "https://search.bilibili.com/all",
+      "login_url": "https://passport.bilibili.com/login",
+      "login_hint": "用B站账号登录 / login with Bilibili account",
+      "capabilities": ["search", "video_ai"],
+      "selectors": {
+        "input": "input.search-keyword, input[placeholder*='搜索']",
+        "submit": "button.search-btn, button[type='submit']",
+        "response": "div.video-list, div.search-result, div.bili-video-card"
+      },
+      "special": "video_search",
+      "enabled": true,
+      "preferred_engine": "chromium",
+      "cookie_domains": ["bilibili.com", ".bilibili.com"]
+    },
+    {
+      "name": "doubao",
+      "display_name": "豆包 / Doubao",
+      "url": "https://www.doubao.com/",
+      "login_url": "https://www.doubao.com/",
+      "login_hint": "用手机号、抖音号或验证码登录 / login with phone, Douyin ID, or SMS code",
+      "capabilities": ["search", "chat", "video_ai"],
+      "selectors": {
+        "input": "textarea[placeholder*='输入'], textarea[placeholder*='问'], div[contenteditable='true']",
+        "submit": "button[type='submit'], button[aria-label*='发送'], button[class*='send']",
+        "response": "div[class*='answer'], div[class*='message-content'], div[class*='chat-content']"
+      },
+      "special": "douyin_video_search",
+      "enabled": true,
+      "preferred_engine": "chromium",
+      "cookie_domains": ["doubao.com", ".doubao.com", ".bytedance.com"]
+    },
+    {
+      "name": "sogou_weixin",
+      "display_name": "搜狗微信搜索（公众号专用） / Sogou WeChat Search",
+      "url": "https://weixin.sogou.com/",
+      "login_url": "https://weixin.sogou.com/",
+      "login_hint": "无需登录，直接使用 / no login required",
+      "capabilities": ["search"],
+      "selectors": {
+        "input": "input#query, input[name='query']",
+        "submit": "input#swz, button[type='submit'], a#swz",
+        "response": "div.results, div.txt-box, div[class*='news-box']"
+      },
+      "special": "weixin_search",
+      "enabled": true,
+      "preferred_engine": "camoufox"
+    },
+    {
+      "name": "baidu",
+      "display_name": "百度搜索 / Baidu Search",
+      "url": "https://www.baidu.com/",
+      "login_url": "https://www.baidu.com/",
+      "login_hint": "无需登录 / no login required",
+      "capabilities": ["search"],
+      "selectors": {
+        "input": "input#kw, input[name='wd']",
+        "submit": "input#su, button[type='submit']",
+        "response": "div#content_left, div.result, div[class*='result']"
+      },
+      "special": null,
+      "enabled": true,
+      "preferred_engine": "camoufox"
+    },
+    {
+      "name": "google",
+      "display_name": "Google搜索 / Google Search",
+      "url": "https://www.google.com/",
+      "login_url": "https://www.google.com/",
+      "login_hint": "无需登录 / no login required",
+      "capabilities": ["search"],
+      "selectors": {
+        "input": "input[name='q'], textarea[name='q']",
+        "submit": "button[type='submit'], button[aria-label*='Search']",
+        "response": "div#search, div.g, div[class*='g']"
+      },
+      "special": null,
+      "enabled": true,
+      "preferred_engine": "camoufox"
+    }
+  ]
+}

browser_ai_cli-0.1.0.data/data/browser_ai_examples/search_routes.example.json

@@ -0,0 +1,111 @@
+{
+  "_说明": "智能搜索路由规则 - 定义任务类型→搜索源的映射。支持并行试探+质量评估+深度搜索。",
+  "_documentation": "Smart search routing. Maps a task type to one or more probe sources. Used by `python browser_ai.py search`.",
+  "_策略说明 / strategy notes": {
+    "probe": "试探阶段：并行查询多个源，每个源只取前3-5条结果 / probe stage: query multiple sources in parallel, take top 3-5 each",
+    "evaluate": "评估阶段：根据结果数量、相关性、独家信息量打分 / evaluate by count, relevance, unique content",
+    "deep_dive": "深度阶段：对高分源进行深度查询 / deep dive on high-scoring sources"
+  },
+  "routes": [
+    {
+      "task_type": "weixin_article",
+      "description": "公众号文章搜索 / WeChat public-account article search",
+      "trigger_keywords": ["公众号", "微信文章", "wechat article", "公众号文章"],
+      "probe_sources": [
+        {"site": "sogou_weixin", "weight": 1.0, "reason": "搜狗微信搜索专搜公众号，覆盖率最高 / sogou is the main aggregator"},
+        {"site": "yuanbao", "weight": 0.9, "reason": "元宝可联网搜索公众号内容并总结 / yuanbao can web-search and summarize"},
+        {"site": "baidu", "weight": 0.5, "reason": "百度可能搜到转载，但非原站 / baidu finds reprints only"},
+        {"site": "google", "weight": 0.4, "reason": "Google对公众号索引有限 / google indexes wechat poorly"}
+      ],
+      "deep_dive_sources": ["yuanbao", "kimi"],
+      "deep_dive_action": "将搜狗找到的文章URL喂给元宝/Kimi总结 / feed urls to yuanbao or kimi for summary"
+    },
+    {
+      "task_type": "general_search",
+      "description": "通用搜索 / general search",
+      "trigger_keywords": [],
+      "probe_sources": [
+        {"site": "baidu", "weight": 0.8, "reason": "中文内容覆盖好 / best Chinese coverage"},
+        {"site": "google", "weight": 0.9, "reason": "综合质量最高 / overall quality"},
+        {"site": "yuanbao", "weight": 0.7, "reason": "AI总结能力强 / strong AI summarization"}
+      ],
+      "deep_dive_sources": ["yuanbao", "kimi"],
+      "deep_dive_action": "让AI总结搜索结果 / let an AI summarize results"
+    },
+    {
+      "task_type": "tech_question",
+      "description": "技术问题 / technical question",
+      "trigger_keywords": ["代码", "bug", "error", "编程", "开发", "API", "框架", "code", "programming", "framework"],
+      "probe_sources": [
+        {"site": "google", "weight": 1.0, "reason": "技术内容索引最好 / best tech indexing"},
+        {"site": "yuanbao", "weight": 0.8, "reason": "可总结技术文档 / can summarize docs"},
+        {"site": "kimi", "weight": 0.7, "reason": "可读长文档 / reads long docs well"}
+      ],
+      "deep_dive_sources": ["kimi", "tongyi"],
+      "deep_dive_action": "把技术文档喂给Kimi读全文并总结 / feed docs to kimi"
+    },
+    {
+      "task_type": "knowledge_qa",
+      "description": "知识问答 / knowledge Q&A",
+      "trigger_keywords": ["是什么", "为什么", "怎么样", "如何", "区别", "what is", "why", "how"],
+      "probe_sources": [
+        {"site": "zhida", "weight": 1.0, "reason": "知乎直答专做知识问答 / zhida is purpose-built"},
+        {"site": "yuanbao", "weight": 0.9, "reason": "联网搜索+总结 / web search + summarize"},
+        {"site": "tongyi", "weight": 0.8, "reason": "通义千问知识面广 / tongyi has broad coverage"}
+      ],
+      "deep_dive_sources": ["zhida", "yuanbao"],
+      "deep_dive_action": "对比多个AI的答案，取共识+补充差异 / compare AI answers"
+    },
+    {
+      "task_type": "video_content",
+      "description": "视频内容理解 / video content understanding",
+      "trigger_keywords": ["视频", "B站", "bilibili", "抖音", "讲什么", "video", "douyin"],
+      "probe_sources": [
+        {"site": "bili_ai", "weight": 1.0, "reason": "B站原生搜索 / native bilibili search"},
+        {"site": "doubao", "weight": 0.95, "reason": "豆包可检索抖音视频并总结 / doubao can search douyin"}
+      ],
+      "deep_dive_sources": ["doubao", "kimi"],
+      "deep_dive_action": "让豆包直接检索抖音视频并总结，或把视频链接喂给Kimi / doubao search, kimi summarize"
+    },
+    {
+      "task_type": "long_text",
+      "description": "长文本处理 / long-text processing",
+      "trigger_keywords": ["总结", "摘要", "读一下", "这篇", "文档", "summarize", "summary", "read"],
+      "probe_sources": [
+        {"site": "kimi", "weight": 1.0, "reason": "Kimi长文本能力最强 / kimi is the strongest"},
+        {"site": "tongyi", "weight": 0.8, "reason": "通义也支持长文本 / tongyi also supports long text"}
+      ],
+      "deep_dive_sources": ["kimi"],
+      "deep_dive_action": "直接喂给Kimi读全文 / feed to kimi"
+    },
+    {
+      "task_type": "news",
+      "description": "新闻资讯 / news",
+      "trigger_keywords": ["新闻", "最新", "今天", "近期", "发生", "news", "today", "recent"],
+      "probe_sources": [
+        {"site": "baidu", "weight": 0.9, "reason": "百度新闻实时性好 / baidu news is fresh"},
+        {"site": "yuanbao", "weight": 1.0, "reason": "元宝联网搜索+总结 / yuanbao web + summary"},
+        {"site": "google", "weight": 0.7, "reason": "Google News / google news"}
+      ],
+      "deep_dive_sources": ["yuanbao"],
+      "deep_dive_action": "让元宝总结新闻要点 / yuanbao summary"
+    }
+  ],
+  "default_route": {
+    "task_type": "general_search",
+    "description": "默认路由：无法识别任务类型时使用 / fallback route",
+    "probe_sources": [
+      {"site": "baidu", "weight": 0.8},
+      {"site": "google", "weight": 0.9},
+      {"site": "yuanbao", "weight": 0.7}
+    ],
+    "deep_dive_sources": ["yuanbao", "kimi"]
+  },
+  "quality_scoring": {
+    "result_count_weight": 0.2,
+    "relevance_weight": 0.4,
+    "unique_info_weight": 0.3,
+    "source_authority_weight": 0.1,
+    "deep_dive_threshold": 0.6
+  }
+}

browser_ai_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,315 @@
+Metadata-Version: 2.4
+Name: browser-ai-cli
+Version: 0.1.0
+Summary: Multi-site AI aggregator CLI for Chinese AI products and search engines (Yuanbao, Kimi, Tongyi, Doubao, Baidu, Sogou WeChat, ...).
+Author-email: Weiming3 <weiming3@users.noreply.github.com>
+License: MIT License
+        
+        Copyright (c) 2026 Weiming
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/Weiming3/browser-ai
+Project-URL: Issues, https://github.com/Weiming3/browser-ai/issues
+Project-URL: Source code, https://github.com/Weiming3/browser-ai
+Keywords: playwright,camoufox,browser-automation,ai-router,ai-aggregator,chinese-ai,wechat-search
+Platform: any
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: camoufox>=0.4.0
+Dynamic: license-file
+
+<p align="center">
+	<span>>简体中文<</span>
+	&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;
+	<a href="README_en.md" lang="en" hreflang="en">English</a>
+</p>
+
+# Browser-AI Toolkit / 浏览器 AI 工具集
+
+<p align="center">
+	<img src="https://stone.professorlee.work/api/stone/Weiming3/browser-ai" alt="Stone Badge">
+</p>
+
+> 一个 CLI，把同一句话同时丢给一堆 AI 和搜索引擎，然后把答案排好序端回来。
+
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Playwright](https://img.shields.io/badge/powered%20by-playwright-green)](https://playwright.dev/)
+
+---
+
+## 这是干嘛的？
+
+`browser-ai` 是一个 Python CLI：把单条查询同时分发给多个 AI 服务（腾讯元宝、Kimi、通义千问、知乎直答、豆包……）和搜索引擎（百度、Google、搜狗微信），等所有源返回后做统一排序，输出一个综合结果。
+
+底层基于 Playwright，提供两个可按站点切换的引擎：
+
+- **Chromium + 持久化 profile**：用于需要保留登录态的站点。
+- **Camoufox**（反检测 Firefox）：用于对普通浏览器进行指纹识别的搜索/抓取类站点。
+
+站点配置完全由 `config/ai_sites.json` 数据驱动。新增站点只需复制一段配置并修改选择器，**无需改动任何 Python 代码**。
+
+---
+
+## 和 OpenRouter / LiteLLM 有什么不同？
+
+看到这里第一反应很可能是「这不就是又一个 AI router 吗？」——问题合理，但**路由对象完全不同**。
+
+|  | OpenRouter / LiteLLM / OneAPI / Portkey | browser-ai |
+|---|---|---|
+| 路由对象 | LLM **API 端点** | AI **网页产品** + **搜索引擎网页** |
+| 调用方式 | HTTP API（OpenAI 兼容格式） | 浏览器自动化（Playwright） |
+| 鉴权 | API Key（按 token 计费） | 你自己的**登录态**（cookie / persistent profile） |
+| 覆盖范围 | 有公开 API 的 LLM 提供商 | 有网页 UI 的一切——**包括没 API 的** |
+| 输出 | 单个模型的文本回复 | 多源页面文本 + **统一打分排序** |
+| 形态 | 后端服务 / 网关 | 本地 CLI |
+
+API router 做不到的三件事，`browser-ai` 都覆盖：
+
+**1. 那些「没 API、只有网页」的源。**
+
+腾讯元宝、知乎直答、Web 版豆包、B 站 AI 总结、搜狗微信——这些都没有公开 API，但都是有用信源。API router 物理上摸不到这一层。
+
+**2. 主流 LLM 看不到的「围墙花园」内容。**
+
+Gemini、GPT、Claude 这类模型有训练截止日期，而且语料重度偏向英文。它们对中文平台围墙内的内容覆盖非常弱：
+
+- **微信公众号**：中文长文的主战场，Google 几乎索引不到，模型训练数据里也稀薄。
+- **百度贴吧、知乎、小红书**：反爬严格、登录门槛高，西方爬虫根本看不见。
+- **中文平台的实时内容**：上周刚发的帖子、新出的爆款文章，模型压根没见过。
+
+`browser-ai` 通过搜狗微信（目前唯一的公开公众号聚合入口）、百度、加上你登录好的元宝 / Kimi 会话，**直接抓活的、带中文场景的真实资料**，而不是问一个 LLM 它几年前的记忆。`weixin` 命令就是为这个场景设计的——搜狗 + 百度 + 元宝三路包抄同一个查询，把 AI 看不到的中文长文搜回来，**给 LLM 的回答补充一个它够不着的思考维度**。
+
+**3. AI + 搜索引擎混合扇出。**
+
+大多数 AI router 只在 LLM 之间扇出。`browser-ai` 把 AI 产品和搜索引擎（百度、Google、搜狗微信）混在同一次查询里——这是「边问 AI、边找参考资料」的唯一实用做法。
+
+**一句话总结**：OpenRouter 做的是「**API 抽象层**」；`browser-ai` 做的是「**网页抽象层**」——把任何带网页的 AI 产品或搜索引擎，捏成一个统一查询目标。
+
+---
+
+## 和 `@playwright/mcp` 有什么不同？
+
+> `@playwright/mcp` 是微软官方维护的 Playwright MCP 服务器：把浏览器自动化能力暴露成 MCP 工具，让 AI agent 可以一步步指挥浏览器。
+
+它和 `browser-ai` **不在同一个层面竞争**——一个把浏览器暴露给 AI，另一个是基于浏览器的预设工作流。
+
+|  | `@playwright/mcp` | browser-ai |
+|---|---|---|
+| 本质 | 通用浏览器遥控器（MCP 工具集） | 预设工作流 CLI |
+| 决策者 | AI agent 自己（一步步操作） | JSON 配置（开箱即用） |
+| 执行模式 | 单标签页串行 | 多站点并行扇出（`asyncio.gather`） |
+| 站点知识 | 通用，每次让 AI 现场摸索 | 预配每个 AI 站点的选择器 / 等待逻辑 |
+| 反检测 | 无 | `navigator.webdriver` 掩蔽 + 可选 Camoufox |
+| 登录态 | 无 explicit 管理 | `config/profiles/` 按站点分目录 + Firefox cookie 导入 |
+| 意图路由 | 无 | `search_routes.json` 按关键词决定探哪些站点 |
+| 评分排序 | 无 | 三阶段 probe → evaluate → deep-dive |
+| 公众号搜索 | 无 | `weixin` 命令三路包抄 |
+
+**一句话总结**：
+
+> `@playwright/mcp` 给 AI agent 一本**空白笔记本和一支笔**；`browser-ai` 是已经填好的**答题卡**，连笔迹都描过一遍了。
+
+### 推荐两者都装
+
+它们解决的问题不同，建议都装：
+
+```bash
+# browser-ai：CLI 工作流（多源聚合、反检测、预配站点）
+pip install playwright camoufox
+playwright install chromium
+camoufox fetch
+
+# @playwright/mcp：MCP 工具集（让 Claude / Cursor / Cline 直接控制浏览器）
+npm install -g @playwright/mcp
+```
+
+- `@playwright/mcp` 适合「**让 AI 自由探索新站点**」的开放场景。
+- `browser-ai` 适合「**中文 AI 产品聚合 + 围墙花园数据获取**」的预设场景。
+
+两个装上互不冲突，按场景切换用。
+
+---
+
+## 快速开始
+
+### 方式一：`pip install`（推荐给最终用户）
+
+```bash
+pip install browser-ai-cli
+playwright install chromium
+
+# 可选：反检测场景用得到
+camoufox fetch
+
+# 首次运行会自动把模板配置拷到 ~/.config/browser-ai/config/
+browser-ai-cli list
+
+# 登录某个站点（会弹一个真的浏览器窗口，自己手动登录一下就行）
+browser-ai-cli login yuanbao
+
+# 全网智能搜索：AI + 搜索引擎一起上
+browser-ai-cli search "python 异步编程最佳实践"
+
+# 公众号文章：搜狗 + 百度 + 元宝三路包抄
+browser-ai-cli weixin "微信公众号 跨境电商"
+```
+
+> pip 安装模式下，配置和登录态落在 `~/.config/browser-ai/`（XDG 风格），和系统其他 dotfiles 一处管理。本地 checkout 模式下仍是仓库根目录的 `config/`，老用户行为不变。
+
+### 方式二：clone 仓库自己改（推荐给二次开发）
+
+```bash
+git clone https://github.com/Weiming3/browser-ai.git
+cd browser-ai
+pip install -r requirements.txt
+playwright install chromium
+
+# 可选：装上 Camoufox，反检测场景用得到
+pip install camoufox
+camoufox fetch
+
+# 把示例配置复制成你自己的本地配置
+cp config/ai_sites.example.json config/ai_sites.json
+cp config/search_routes.example.json config/search_routes.json
+
+# 看看现在接了哪些站点
+python scripts/browser_ai.py list
+
+# 登录某个站点（会弹一个真的浏览器窗口，自己手动登录一下就行）
+python scripts/browser_ai.py login yuanbao
+
+# 全网智能搜索：AI + 搜索引擎一起上
+python scripts/browser_ai.py search "python 异步编程最佳实践"
+
+# 想单独戳某个源也行
+python scripts/browser_ai.py probe "kimi 长文本"
+```
+
+---
+
+## 从 Firefox 导入已有登录态
+
+如果某些站点你已经在 Firefox 里登录过，不必再手动登录一次。`scripts/import_firefox_login.py` 会读取你本机 Firefox 的 `cookies.sqlite` 数据库，把对应的 cookie 写入到 `config/profiles/` 下对应的 Chromium profile 目录中。
+
+```bash
+# 先 dry-run 看看会动哪些 cookie
+python scripts/import_firefox_login.py --dry-run
+
+# 确认无误后再真跑
+python scripts/import_firefox_login.py
+
+# 只导入某个站点的 cookie
+python scripts/import_firefox_login.py --site yuanbao
+```
+
+强烈建议第一次使用先跑 `--dry-run` 预览。
+
+---
+
+## 目录结构
+
+```
+browser-ai/
+├── scripts/
+│   ├── browser_ai.py             # 主 CLI
+│   ├── import_firefox_login.py   # Firefox 登录态搬运工
+│   └── pre-commit-check.py       # 提交前安全检查
+├── config/
+│   ├── ai_sites.example.json     # 模板，复制成 ai_sites.json
+│   └── search_routes.example.json
+├── tests/
+│   └── test_smoke.py             # 26 个冒烟测试
+├── README.md
+├── README_en.md
+├── LICENSE
+├── pyproject.toml         # pip 包元数据 + entry point
+├── requirements.txt
+├── .gitignore
+└── .gitattributes
+```
+
+---
+
+## 加一个新 AI 站点
+
+最快是跑向导：
+
+```bash
+python scripts/browser_ai.py add-site
+```
+
+愿意直接改 JSON 的话，从 `config/ai_sites.json` 里复制一段 site，改这几个字段就够了：`name`、`url`、`login_url`、`login_hint`、`selectors.input`、`selectors.submit`、`selectors.response`、`preferred_engine`。重启 CLI，新站点就上线了。
+
+---
+
+## 引擎怎么选？
+
+| 引擎 | 适用场景 |
+|------|----------|
+| Chromium + profile | 需要登录态的站点（元宝、Kimi、豆包、B站）。 |
+| Camoufox | 搜索/抓取类站点对无头 Chromium 不友好（百度、Google、搜狗微信）。 |
+
+在 `ai_sites.json` 里给每个站点设一个 `preferred_engine` 就完事，**只这一个开关**。两个引擎相互独立——想留就留，想拆就拆，反正不是承重墙。
+
+---
+
+## 真正要看两眼的就这两件事
+
+**一、登录态别往仓库里塞。**
+
+`config/profiles/` 里装的是 cookies、localStorage、IndexedDB，基本等同于每个站点的活动登录会话。`.gitignore` 默认已经把它排除在外了，**别动这一行**。真正的 `config/ai_sites.json` 也在 gitignore 里，模板是 `*.example.json` 那两份。仓库自带的 `scripts/pre-commit-check.py` 会拦下任何想偷偷把这俩文件加进去的 commit。建议这样用：
+
+```bash
+python scripts/pre-commit-check.py                       # 每次提交前手动跑
+cp scripts/pre-commit-check.py .git/hooks/pre-commit   # 装成 git hook 自动拦截
+```
+
+**二、站点的服务条款还是老大。**
+
+绝大多数 AI 平台的服务条款都明确禁止自动化访问。本工具就自己研究用，别拿去当爬虫服务赚钱，也别去薅别人的付费内容。被限流、被封 IP、被发律师函，都跟作者没关系，谢谢。
+
+---
+
+## 一些零碎
+
+- `login` 和 `--headed` 一定弹窗，其他命令默认静默。
+- 百度/Google 无头模式有时候会跳验证码，加 `--headed` 就行。
+- 默认配置是样例，**不是真理**。按自己工作流改好再发给别人看。
+
+---
+
+## 许可证
+
+MIT —— 见 [LICENSE](LICENSE)。

browser_ai_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+browser_ai_cli-0.1.0.data/data/browser_ai_examples/ai_sites.example.json,sha256=GLQqRgorlNo4DEvfX9SuoFjeqGFCEN3yJRevWnKXCdk,8559
+browser_ai_cli-0.1.0.data/data/browser_ai_examples/search_routes.example.json,sha256=52uXtuSav6qq0YoRCPkv5BHs3of3GR7PNxp2kYSvdgs,6081
+browser_ai_cli-0.1.0.dist-info/licenses/LICENSE,sha256=VFcgtGlefSn5dCufuTGUcTkC9qiaYTQdU8oaifH0634,1063
+scripts/__init__.py,sha256=phF_ZGzviP7FtHvxsLkAc0gb2OPHRSLxgkOWU9ySXWM,253
+scripts/browser_ai.py,sha256=aycVUsa37toUJ-XEI3i6TR4WeA_roVtpefTNpWeiIZA,29145
+scripts/import_firefox_login.py,sha256=XSv4KzyHqJ--TU_Aqj4kA1pFhDmn93B_eJDBY4XW1vI,17767
+scripts/pre-commit-check.py,sha256=6Uiqb4IHYkXE7NbSdVr3OS7ZKlx8Wi2YbovVNhurDiA,5906
+browser_ai_cli-0.1.0.dist-info/METADATA,sha256=i4ecsF4UuY-pbTZX3D1BfrgfunZgMZ4C2qEiCCzWad0,13587
+browser_ai_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+browser_ai_cli-0.1.0.dist-info/entry_points.txt,sha256=Zs2eP03QShY3AjJuOin9aLFyZOa5vJYKi-diS_LkHlo,59
+browser_ai_cli-0.1.0.dist-info/top_level.txt,sha256=rmzd5mewlrJy4sT608KPib7sM7edoY75AeqJeY3SPB4,8
+browser_ai_cli-0.1.0.dist-info/RECORD,,

browser_ai_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

browser_ai_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+browser-ai-cli = scripts.browser_ai:main

browser_ai_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Weiming
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

browser_ai_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+scripts