https://github.com/serpapi/serpapi-cursor-plugin
Cursor Plugin for SerpApi API.
https://github.com/serpapi/serpapi-cursor-plugin
Last synced: 9 days ago
JSON representation
Cursor Plugin for SerpApi API.
- Host: GitHub
- URL: https://github.com/serpapi/serpapi-cursor-plugin
- Owner: serpapi
- License: mit
- Created: 2026-04-24T10:16:20.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-01T08:08:03.000Z (12 days ago)
- Last Synced: 2026-06-01T10:08:35.277Z (12 days ago)
- Language: Python
- Homepage: https://serpapi.com/
- Size: 277 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
SerpApi Plugin for Cursor
A [Cursor plugin](https://cursor.com/docs/plugins) that gives Cursor Agent the ability to search Google, Amazon, Walmart, YouTube, Google Maps, Google Scholar, and [100+ other engines](https://serpapi.com/search-engine-apis) via the [SerpApi](https://serpapi.com) REST API.
[](LICENSE)
[](engines/)
[](https://github.com/serpapi/serpapi-cursor-plugin/actions/workflows/validate.yml)
[](https://github.com/serpapi/serpapi-cursor-plugin/actions/workflows/update-engines.yml)
## Quick Start
### 1. Get an API key
Sign up at [serpapi.com](https://serpapi.com/users/sign_up?plan=free) and set the key:
> **Free tier** - 250 searches/month, no credit card required.
```bash
export SERPAPI_API_KEY="your_key_here"
```
### 2. Install the plugin
**Local install** (recommended for testing):
```bash
# Option A: Copy the plugin
cp -r /path/to/serpapi-cursor-plugin ~/.cursor/plugins/local/serpapi
# Option B: Clone directly
git clone https://github.com/serpapi/serpapi-cursor-plugin.git ~/.cursor/plugins/local/serpapi
```
Then restart Cursor or run `Developer: Reload Window` from the command palette.
**From the marketplace** (when available):
Search for "serpapi" in the Cursor marketplace panel, or visit [cursor.com/marketplace](https://cursor.com/marketplace).
### 3. Use it
Cursor Agent 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:
```
/search coffee shops near Times Square
```
You can also attach it as context:
```
@search
```
## Features
- **Single skill, all engines** - `/search` covers all 100+ SerpApi engines. Cursor Agent 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** - Cursor Agent 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 the agent 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/`](engines/).
## Troubleshooting
- **"Invalid API key"**: Verify at [serpapi.com/manage-api-key](https://serpapi.com/manage-api-key)
- **Plugin not showing up**: Ensure files are in `~/.cursor/plugins/local/serpapi/` and restart Cursor
- **Skill not loading**: Run `Developer: Reload Window` from the command palette
- **Rate limit exceeded**: Wait or [upgrade your plan](https://serpapi.com/pricing)
## Development
Engine schemas are auto-generated by `build-engines.py` and updated weekly via [GitHub Actions](.github/workflows/update-engines.yml).
To regenerate manually:
```bash
pip install -r requirements.txt
python build-engines.py
```
To validate the plugin structure:
```bash
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 Plugin for Claude Code](https://github.com/serpapi/serpapi-claude-plugin) - Claude Code plugin with the same capabilities
- [SerpApi MCP Server](https://github.com/serpapi/serpapi-mcp) - MCP server integration for Claude Desktop, VS Code, and Cursor
- [SerpApi Docs](https://serpapi.com/search-api) - Full API reference
- [SerpApi Playground](https://serpapi.com/playground) - Interactive API explorer
## License
MIT License - see [LICENSE](LICENSE) file for details.