Skip to content

仓库 files navigation

SerpApi Plugin for Claude Code

A Claude Code plugin that gives Claude the ability to search Google, Amazon, Walmart, YouTube, Google Maps, Google Scholar, and 100+ other engines via the SerpApi REST API.

MIT License Engines CI

Quick Start

1. Get an API key

注册 at serpapi.com and set the key:

Free tier - 250 searches/month, no credit card required.

export SERPAPI_API_KEY="your_key_here"

2. Install the plugin

From the marketplace (two steps - register the catalog, then install):

/plugin marketplace add serpapi/serpapi-claude-plugin
/plugin install serpapi@serpapi-plugins

From source:

claude --plugin-dir /path/to/serpapi-claude-plugin

3. Use it

Claude will automatically use SerpApi when you ask it to search for something. Just ask in natural language:

搜索 Google for the best Python web frameworks

比较 prices for AirPods Pro on Amazon, Walmart, and eBay

Find academic papers about transformer architectures published after 2020

Or invoke the skill explicitly:

/serpapi:search coffee shops near Times Square

Features

  • Single skill, all engines - /serpapi:search covers all 100+ SerpApi engines. Claude picks the right one based on your intent.
  • Always up to date - Engine parameter schemas are auto-generated and kept fresh by weekly CI.
  • Auto-invocation - Claude detects search-related requests and loads the skill automatically. No need to remember slash commands.
  • Cost-aware - Defaults to google_light (faster, cheaper) for simple web searches. Confirms before making API calls.
  • Schema-driven - The plugin ships a complete engine selection table and JSON schemas for every engine's parameters, so Claude can construct the right API call without guessing.

Supported Engines

Category Engines
Web 搜索 Google, Google Light, Bing, DuckDuckGo, Yahoo, Yandex, Baidu, Naver
AI 搜索 Google AI Mode, Google AI Overview, Bing Copilot, Brave AI Mode
Shopping Amazon, Walmart, eBay, Google Shopping, Home Depot
Local / Maps Google Maps, Google Local, Yelp, TripAdvisor, OpenTable
Research Google Scholar, Google Patents, Google Trends
新建s Google 新建s, Bing 新建s, DuckDuckGo 新建s, Baidu 新建s
Media Google Images, Google Videos, YouTube, Google Lens
Travel Google Flights, Google Hotels, Google Travel 探索
Jobs Google Jobs
Finance Google Finance
Apps Google Play, Apple App Store

See the full list in engines/.

Troubleshooting

Development

Engine schemas are auto-generated by build-engines.py and updated weekly via GitHub 操作.

To regenerate manually:

pip install -r requirements.txt
python build-engines.py

To validate the plugin structure:

bash test.sh

Contributing

  1. 复刻 the repository
  2. Create your feature branch: git checkout -b feature/amazing-feature
  3. Make your changes
  4. Run validation: bash test.sh
  5. Commit changes: git commit -m 'Add amazing feature'
  6. Push to branch: git push origin feature/amazing-feature
  7. Open a Pull Request

Related

License

MIT License - see LICENSE file for details.

发布

贡献者

Languages