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.
Quick Start
1. Get an API key
Sign up 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:
Search Google for the best Python web frameworks
Compare 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:searchcovers 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 Search | Google, Google Light, Bing, DuckDuckGo, Yahoo, Yandex, Baidu, Naver |
| AI Search | 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 |
| News | Google News, Bing News, DuckDuckGo News, Baidu News |
| Media | Google Images, Google Videos, YouTube, Google Lens |
| Travel | Google Flights, Google Hotels, Google Travel Explore |
| Jobs | Google Jobs |
| Finance | Google Finance |
| Apps | Google Play, Apple App Store |
See the full list in engines/.
Troubleshooting
- "Invalid API key": Verify at serpapi.com/manage-api-key
- Skill not loading: Run
/reload-pluginsinside Claude Code - Rate limit exceeded: Wait or upgrade your plan
Development
Engine schemas are auto-generated by build-engines.py and updated weekly via GitHub Actions.
To regenerate manually:
pip install -r requirements.txt
python build-engines.py
To validate the plugin structure:
bash test.sh
Contributing
- Fork the repository
- Create your feature branch:
git checkout -b feature/amazing-feature - Make your changes
- Run validation:
bash test.sh - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
Related
- SerpApi MCP Server - MCP server integration for Claude Desktop, VS Code, and Cursor
- SerpApi Docs - Full API reference
- SerpApi Playground - Interactive API explorer
License
MIT License - see LICENSE file for details.