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: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 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-plugins inside 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

1. Fork 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

• 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.