majiayu000 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,
Start executing curl for search
Report example for python script,
Start executing python extract.py for context extraction
Tips:
- Use specific queries for better results
- Limit results to what you need
- Use freshness filters for time-sensitive info
- Always check response status codes