A comprehensive multi-type search tool powered by SearchAPI to provide AI agents with real-time web, news, finance, and map data.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install searchapi
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install searchapi using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WebSearchAPI?
WebSearchAPI is a robust search integration designed specifically for AI agents within the Openclaw Skills framework. By leveraging the SearchAPI (Google) backend, it allows autonomous agents to break free from training data cutoffs and access the live web. Whether your agent needs to track stock prices, find local businesses on maps, or summarize the latest news, this skill provides the necessary bridge to real-time information.
The tool is built with a focus on stability and developer experience, featuring automatic retries for network resilience and zero external dependencies. This makes it a lightweight yet powerful addition to any developer's Openclaw Skills library, ensuring that agents can deliver accurate, up-to-the-minute responses across various search verticals like Finance, Hotels, and Flights.
WebSearchAPI Use Cases
- Real-time news monitoring and summarization for trending topics.
- Financial analysis and stock market tracking using the finance search type.
- Automated travel research, including flight and hotel availability checks.
- Local business discovery and contact information retrieval via Maps integration.
- Enhancing AI agent reasoning with current web data to avoid hallucinations.
How WebSearchAPI Works
- The AI agent or user executes a command via the CLI, specifying the search type (e.g., news, finance) and keywords.
- The script validates the local configuration and retrieves the securely stored SearchAPI key.
- A request is dispatched to the SearchAPI engine with optional parameters like time filtering or geographic location.
- The tool handles potential network errors through an automated retry mechanism to ensure high availability.
- The raw engine response is processed into a structured, agent-ready JSON format and returned to the caller.
WebSearchAPI Setup
To integrate this search capability into your Openclaw Skills workflow, follow these steps:
# Navigate to the tool directory
cd tools/websearchapi
# Configure your SearchAPI key (obtain from searchapi.io)
node websearchapi.js config set-key YOUR_API_KEY
# Optional: Set default result count and language
node websearchapi.js config set-num 10
node websearchapi.js config set-lang en
WebSearchAPI Data Schema & Taxonomy
WebSearchAPI returns data in a structured JSON format designed for easy parsing by LLMs. The schema includes success status, query metadata, and a detailed results array:
| Field | Type | Description |
|---|---|---|
success |
Boolean | Indicates if the search was successful |
results |
Array | Contains title, link, snippet, and source for each hit |
metadata |
Object | Includes total results count and time taken |
type |
String | The search engine used (default: google) |
Configuration is stored locally in a config.json file within the tool directory.
WebSearchAPI Advanced Features
- Multi-Vertical Support: Access specialized search engines for News, Videos, Finance, Maps, Hotels, and Flights through a single interface.
- Granular Time Filtering: Restrict results to the last hour, day, week, month, or year for highly relevant temporal data.
- Zero-Dependency Architecture: Built entirely on Node.js built-in modules for maximum portability across Openclaw Skills environments.
- Resilient Networking: Customizable retry logic (
set-retry) to handle intermittent API or network failures. - Localization Controls: Fine-tune search results by country (
gl) and language (lang) for localized AI assistance.
SKILL.md
Loading
Related Openclaw Skills
ohmytoken-tracker
A mesmerizing real-time pixel art visualizer that tracks and displays your AI token consumption across various LLM models.
Health Tracking
A comprehensive health data management system that logs physiological metrics, workouts, and uses AI vision to analyze nutritional content from food photos.
Health-Proactive
A proactive health monitoring skill that detects and alerts users about missed meals, insufficient hydration, and overdue deadlines.
Credit Control & Collections Framework
An end-to-end operational framework for assessing customer creditworthiness, managing trade risk, and executing systematic debt collection protocols.
Voice Extractor
Voice Extractor analyzes writing samples to create a comprehensive Voice Guide that captures a person's unique communication DNA for AI training and brand consistency.
Extropy Operator
Extropy Operator is an execution-first skill designed to run complex simulation pipelines, diagnose failures, and deliver evidence-backed analysis using strict quality gates.
Featured*
