### 1.1 插件简介与定位**opencode-crawl4ai** 是 OpenCode 的无限制网络访问插件基于 [crawl4ai](https://github.com/unclecode/crawl4ai) 项目实现。它让 AI 能够抓取任意网页内容、执行搜索、截取截图、进行深度爬取打破 AI 训练数据的时间限制。**核心定位**让 AI 具备实时网络访问能力获取最新信息。### 1.2 核心功能特点| 功能 | 说明 ||------|------|| **Fetch** | 获取任意 URL 内容返回 Markdown 或原始 HTML支持隐身模式和 JS 执行 || **Search** | 通过 SearXNG首选或 DuckDuckGo回退进行网页搜索 || **Extract** | 使用 CSS 选择器从网页提取结构化数据 || **Screenshot** | 捕获网页全页截图base64 格式 || **Crawl** | 使用 BFS/DFS 策略深度爬取网站 || **Map** | 发现网站上的所有 URL |### 1.3 系统要求- OpenCode 环境- Python 3.10 且安装了 uvx通过 pip install uv 安装- Docker可选用于 SearXNG 加速搜索### 1.4 安装与配置#### 标准安装bash# 使用 bunx 安装bunx opencode-crawl4ai --install# 或使用 npx 安装npx opencode-crawl4ai --install# 全局安装npm install -g opencode-crawl4aiopencode-crawl4ai --install安装后插件会自动复制到 ~/.config/opencode/plugins/ 目录重启 OpenCode 即可激活。#### 可选SearXNG 加速搜索使用 SearXNG 可以获得更快的搜索速度和更好的隐私保护bash# 启动 SearXNG默认端口 8888opencode-crawl4ai searxng# 指定端口opencode-crawl4ai searxng 8080# 设置环境变量export SEARXNG_URLhttp://localhost:8888# 停止 SearXNGopencode-crawl4ai searxng-stop### 1.5 CLI 命令详解| 命令 | 说明 ||------|------|| opencode-crawl4ai --install | 复制插件到 ~/.config/opencode/plugins/ || opencode-crawl4ai --uninstall | 移除插件 || opencode-crawl4ai searxng [port] | 启动 SearXNG Docker 容器默认端口 8888 || opencode-crawl4ai searxng-stop | 停止 SearXNG 容器 || opencode-crawl4ai --help | 显示帮助信息 |### 1.6 可用工具详解#### crawl4ai_fetch — 获取 URL 内容javascript// 基本用法获取 Markdown 格式内容crawl4ai_fetch({ url: https://docs.example.com })// 获取原始 HTMLcrawl4ai_fetch({ url: https://example.com, format: html })// 等待动态内容加载crawl4ai_fetch({ url: https://spa.example.com, wait_for: .content-loaded })// 执行 JavaScript 后获取内容crawl4ai_fetch({ url: https://example.com, js_code: document.querySelector(.show-more).click() })#### crawl4ai_search — 网页搜索javascript// 基本搜索crawl4ai_search({ query: React hooks tutorial })// 限制结果数量crawl4ai_search({ query: Python asyncio, limit: 5 })#### crawl4ai_extract — 结构化数据提取javascript// 使用 CSS 选择器提取结构化数据crawl4ai_extract({url: https://example.com/product,schema: {title: h1.product-name,price: .price,description: .product-desc}})#### crawl4ai_screenshot — 网页截图javascript// 基本截图crawl4ai_screenshot({ url: https://example.com })// 指定分辨率crawl4ai_screenshot({ url: https://example.com, width: 1920, height: 1080 })#### crawl4ai_crawl — 深度爬取javascript// 限制页面数量的爬取crawl4ai_crawl({ url: https://docs.example.com, max_pages: 20 })// BFS 策略爬取crawl4ai_crawl({ url: https://example.com, strategy: bfs, max_depth: 2 })// DFS 策略爬取crawl4ai_crawl({ url: https://example.com, strategy: dfs, max_depth: 3 })#### crawl4ai_map — URL 发现javascript// 发现网站所有 URLcrawl4ai_map({ url: https://example.com })// 带关键词筛选crawl4ai_map({ url: https://example.com, search: pricing })#### 辅助工具javascript// 获取插件版本crawl4ai_version()// 调试插件状态crawl4ai_debug()### 1.7 环境变量| 变量 | 说明 | 默认值 ||------|------|--------|| SEARXNG_URL | SearXNG 实例的 URL | 无回退到 DuckDuckGo |### 1.8 工作原理插件的 TypeScript 层在每次工具调用时动态启动 Python 桥接进程uvx --with crawl4ai --with ddgs python bridge.py这种方式的优势- **无需持久化 Python 进程**按需启动减少资源占用- **环境隔离**每次调用都是干净的环境- **快速响应**Python 进程启动开销极小### 1.9 适用场景- 获取官方文档最新内容- 研究竞品技术实现- 爬取结构化数据进行分析- 截取网页作为参考截图- 探索不熟悉的技术栈### 1.10 相关链接- **仓库地址**https://github.com/bewinxed/opencode-crawl4ai- **许可证**MIT- **依赖项目**https://github.com/unclecode/crawl4ai---