SerpBear

SerpBear 是一个开源的搜索引擎排名追踪工具，可以追踪你的网站在 Google 中的关键词排名，并在排名变化时发送通知。

功能特点

• 无限关键词： 可添加无限个域名和关键词进行排名追踪
• 可配置抓取深度： 可设置抓取 10-100 个搜索结果（节省 API 费用）
• 智能提前终止： 找到你的域名排名后自动停止抓取（节省 API 费用）
• 邮件通知： 支持每日/每周/每月邮件通知关键词排名变化
• 内置 API： 可用于营销和数据报告工具
• Google Search Console 集成： 获取每个关键词的实际访问量、展示量等数据
• 移动端支持： 支持 PWA，可添加到手机桌面使用

数据服务商

本版本使用 DataForSEO Google Organic SERP API。

服务商	费用	计费方式	官网
DataForSEO	每次 $0.002	按量付费	https://dataforseo.com

快速开始

1. 克隆仓库

git clone https://github.com/tod-zhang/serpbear.git
cd serpbear

2. 创建 .env 配置文件

cat > .env << 'EOF'
USER_NAME=admin
PASSWORD=你的登录密码
SECRET=随机32位字符串用于加密
APIKEY=随机API密钥
SESSION_DURATION=24
NEXT_PUBLIC_APP_URL=http://你的服务器IP:3000
EOF

3. Docker 启动

docker compose up -d --build

4. 访问应用

浏览器打开 http://你的服务器IP:3000

配置说明

DataForSEO 设置

1. 在 DataForSEO 注册账号
2. 进入 API Access 页面获取凭证
3. 在 SerpBear 中进入 Settings → Scraper：
   • Scraping Method： 选择 DataForSEO
   • API Key： 输入 邮箱:密码 格式
   • Scrape Depth： 选择抓取深度（1=10个结果，10=100个结果）

重要提示

• API Key 格式： 必须是 邮箱:密码 格式（例如：hello@example.com:bb2d29f1fb7033a6）
• 密码大小写： API 密码区分大小写，请使用 DataForSEO 提供的原始密码
• 抓取深度： 深度越低费用越低，建议从 50 个结果开始，根据需要调整
• 提前终止： 一旦在结果中找到你的域名，抓取会自动停止以节省费用

环境变量说明

变量	说明	示例
USER_NAME	登录用户名	admin
PASSWORD	登录密码	your_secure_password
SECRET	加密密钥（32位以上）	abc123def456...
APIKEY	内部 API 密钥	serpbear_api_key
SESSION_DURATION	会话时长（小时）	24
NEXT_PUBLIC_APP_URL	应用访问地址	http://localhost:3000

技术栈

• Next.js（前端和后端）
• SQLite（数据库）
• Docker（部署）
• DataForSEO（SERP 数据）

许可证

MIT License