Skip to content

serpapi/serpapi-claude-plugin

Repository 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

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

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

License

MIT License - see LICENSE file for details.

About

Claude Plugin for SerpApi API.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors