# Web Search API

> Search the web and extract content using WebSearchAPI.ai. Use when needing real-time web data, current information, news, research, or when asked to search the internet. Supports web search, content extraction, and web scraping with advanced filtering options.

- Skill: `majiayu000/web-search-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/web-search-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/web-search-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/web-search-api

---

 
# Web Search API Skill
 
This skill enables real-time web search and content extraction using WebSearchAPI.ai, providing Google-quality results optimized for AI applications.

## API Key

API key for websearchapi.ai is stored in .env file in the format of,
WEBSEARCHAPI_KEY=api-key-value

Before execute curl or python scripts for search and extract, you need to read the API key from the .env file and setup it as environment variable by shell command

export WEBSEARCHAPI_KEY=api-key-value

and report to stdout that the WEBSEARCHAPI_KEY is loaded from .env file and setup as environment variable.
 
## Curl command for web search and context extraction
 
Basic Web Search - use the following curl command:
curl -X POST "https://api.websearchapi.ai/v1/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WEBSEARCHAPI_KEY" \
  -d '{"query": "YOUR_SEARCH_QUERY", "num_results": 10}'
 
Advanced Options:
- Geographic filtering: Add "country": "US", "language": "en"
- Time filtering: Add "freshness": "day|week|month|year"
- Full content: Add "include_content": true
 
Content Extraction:
curl -X POST "https://api.websearchapi.ai/v1/extract" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WEBSEARCHAPI_KEY" \
  -d '{"url": "https://example.com", "output_format": "markdown"}'

### Report curl and python scripts execution

You need to report the status of the skill invocation to stdout.
- Report 'Start executing {cli-command} for {purpose}' before invoking curl or python scripts
- Report '{cli-command} execution done' after curl or python script execution finished

cli-command is the curl or python scripts in this skill you invoked and purpose is search or extract.

Report example for curl command,
```curl
Start executing curl for search
```

Report example for python script,
```python
Start executing python extract.py for context extraction
```
 
## Tips:
1. Use specific queries for better results
2. Limit results to what you need
3. Use freshness filters for time-sensitive info
4. Always check response status codes