Agent skill

serpapi-install-auth

Install SerpApi client and configure API key authentication. Use when setting up SerpApi for search result scraping, configuring API keys, or initializing the serpapi Python/Node package. Trigger: "install serpapi", "setup serpapi", "serpapi auth", "serpapi API key".

Stars 1,803
Forks 241

Install this agent skill to your Project

npx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/main/plugins/saas-packs/serpapi-pack/skills/serpapi-install-auth

SKILL.md

SerpApi Install & Auth

Overview

Install the SerpApi client library and configure API key authentication. SerpApi provides structured JSON results from Google, Bing, YouTube, and 15+ search engines. Auth is API-key-based via the api_key parameter or SERPAPI_API_KEY env var.

Prerequisites

Instructions

Step 1: Install Client

bash
# Python (official)
pip install serpapi

# Node.js (official)
npm install serpapi

# Alternative Python package (legacy but widely used)
pip install google-search-results

Step 2: Configure API Key

bash
# .env
SERPAPI_API_KEY=your-api-key-here

Step 3: Verify Connection (Python)

python
import serpapi, os

client = serpapi.Client(api_key=os.environ["SERPAPI_API_KEY"])
result = client.search(engine="google", q="test", num=1)
print(f"Connected! Search ID: {result['search_metadata']['id']}")

Step 4: Verify Connection (Node.js)

typescript
import { getJson } from 'serpapi';

const result = await getJson({
  engine: 'google', q: 'test', num: 1,
  api_key: process.env.SERPAPI_API_KEY,
});
console.log(`Connected! Search ID: ${result.search_metadata.id}`);

Step 5: Check Account

bash
curl "https://serpapi.com/account.json?api_key=$SERPAPI_API_KEY" | jq '{
  plan: .plan_name, used: .this_month_usage, remaining: .plan_searches_left
}'

Output

Connected! Search ID: 64a1b2c3d4e5f6
{ plan: "Developer", used: 42, remaining: 4958 }

Error Handling

Error Cause Solution
Invalid API key Wrong or missing key Check serpapi.com/manage-api-key
Your account is disabled Exceeded limits Upgrade or wait for monthly reset
ModuleNotFoundError Not installed pip install serpapi

Resources

Next Steps

Proceed to serpapi-hello-world for your first search.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results