Repository avatar
AI Tools
v1.0.0
active

easyserp

io.github.aiispower/easyserp

Search Google and Bing through MCP with source-domain filters and safe request recovery.

Documentation

easyserp

easyserp icon

easyserp and easybrSearch family banner

用 Google 和 Bing 搜索 API,为 AI Agent 和自动化任务提供结构化网页结果。支持 2000 QPS;在 控制台注册一次赠送 1000 次搜索,之后 ¥2/1000 次。赠送额度为一次性,不是每月额度。

GitHub · Gitee · 1.0.0 下载 · 免费 easybrSearch

Claude Code 直接安装

无需 npm 发布账号,直接从 GitHub 安装这组搜索技能:

claude plugin marketplace add aiispower/easyserp
claude plugin install easyserp@easy-search-tools
claude plugin install easybr-search@easy-search-tools

需要 Node.js。easyserp 首次使用在控制台注册并配置 API key;easybrSearch 使用已有浏览器连接,完全免费。

Claude Desktop / MCP

从 1.0.0 下载页获取 easyserp-1.0.0.mcpb,在支持 MCPB 的客户端导入,配置 API key 后即可使用。包内已包含运行依赖,需要 Node.js 20+。详细步骤见 MCPB 安装说明。

已发布到 MCP 官方目录,版本 1.0.0。

开始使用

在控制台注册并创建 API key,然后将密钥放入环境变量(不要粘贴到聊天或命令参数中):

export EASYSERP_API_KEY='你的密钥'

把本仓库中的 skills/easyserp/ 安装为 Agent Skill,或在支持 Skill 的 Agent 中按需调用。Skill 会运行随包提供的 CLI,用户无需编写集成代码:

使用 easyserp 搜索 Google 和 Bing 上关于 [主题] 的资料,比较结果并保留来源链接。

也可从源码目录直接运行 CLI:

node src/cli.mjs search "solar power" --engine google --region US --format markdown
node src/cli.mjs batch ./queries.json --concurrency 4
node src/cli.mjs request REQUEST_ID

request 用于查看 queued/running 的待处理请求。网络结果未知时保留 request ID 和幂等键,按指南恢复,不要换新键重复发起。

选择适合的工具

  • easyserp:适合可重复、结构化或程序化的 Google/Bing 网页搜索。CLI、MCP 与 API 使用同一按量计费服务。
  • easybrSearch:免费的浏览器研究 Skill/CLI,复用已连接的浏览器搜索网站、自媒体和代码项目,并读取选定页面。源码:GitHub,Gitee。它不需要 easyserp API key,也不包含 easyserp 的 API 配额。

两者可按任务互补:用 easybrSearch 做广泛的站点探索和阅读;需要程序化 Google/Bing 结果时用 easyserp。更多检索资料要继续用于选题、内容制作与多平台发布时,可选用 aimeGeo 的相关工作流。

开发者与集成

HTTP API、MCP stdio、本地安装与 SDK 说明见集成指南;完整字段和恢复约定见 API 参考。SDK 是给开发者的可选集成方式,普通用户优先使用 Skill 或 CLI。

开源客户端、CLI、MCP 适配器和 Skill 使用 MIT 许可;托管搜索服务按量计费。市场提交及上架状态见渠道与发布材料,仅在实际提交后更新。

介绍与示例:产品组合介绍 · Claude/Codex 接入教程 · 各平台短文案。

English: README.en.md.

MCPB
https://github.com/aiispower/easyserp/releases/download/v1.0.0/easyserp-1.0.0.mcpb
Install Command
# mcpb: https://github.com/aiispower/easyserp/releases/download/v1.0.0/easyserp-1.0.0.mcpb