SerpApi Plugin for Cursor

A Cursor plugin that gives Cursor Agent 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

注册 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

Local install (recommended for testing):

# 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):

搜索 for "serpapi" in the Cursor marketplace panel, or visit 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:

搜索 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:

/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 搜索	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

• "Invalid API key": Verify at 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

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

• SerpApi Plugin for Claude Code - Claude Code plugin with the same capabilities
• 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.