metaso-search

What This Skill Does

The Metaso Search skill acts as a robust gateway for OpenClaw AI agents to perform advanced information retrieval tasks. It provides direct, programmatic access to the Metaso Search API, enabling agents to transcend their internal knowledge limitations by accessing real-time, global data. Whether you need to synthesize information from academic papers, navigate complex web content, or perform context-aware RAG (Retrieval-Augmented Generation) queries, this skill handles the heavy lifting. It abstracts the complexity of HTTP requests, error handling, and environment configuration into three intuitive methods: metaso_web_search for discovery, metaso_web_reader for precise parsing, and metaso_chat for intelligent, grounded conversation.

Installation

To integrate this skill, first ensure you have the OpenClaw environment properly initialized. Install the package directly from the repository using the following command: clawhub install openclaw/skills/skills/xinmh1338863/metaso-search-v2 Once installed, you must authenticate your agent. Securely obtain your Metaso API key and add it to your openclaw.json configuration file under the env object. For temporary session testing, you may set the METASO_API_KEY environment variable in your terminal (Linux/macOS: export METASO_API_KEY="key"; Windows PowerShell: $env:METASO_API_KEY="key"). Ensure your environment is refreshed before executing any agent tasks to prevent authorization errors.

Use Cases

This skill is highly versatile and serves several professional domains. Researchers can use metaso_web_search to find the latest peer-reviewed journals or trends in specific industries. Developers can utilize metaso_web_reader to parse documentation or changelogs from external websites into structured formats like JSON or Markdown for further processing. For AI-driven support agents, metaso_chat allows for the creation of smart help-desk bots that answer user queries based on current, live web documentation rather than static, outdated training data.

Example Prompts

1. "Perform a research query for the latest advancements in quantum computing, focusing on documents and articles published within the last month."
2. "Go to https://api-documentation-site.com and read the latest endpoint definitions, returning the output in JSON format."
3. "Summarize the recent discussions regarding AI ethics from reliable news sources, providing a concise report with citations."

Tips & Limitations

To maximize the utility of this skill, ensure that the scope parameter is set correctly (e.g., 'webpage', 'document') to filter out irrelevant noise. When performing large-scale data gathering, be mindful of the size parameter to avoid exceeding token limits during the parsing phase. Note that while the tool supports real-time search, the quality of answers is dependent on the availability and accessibility of the target website. Always verify the METASO_API_KEY if you encounter unexpected access failures, and utilize the provided quick-test.js or simple-test.js scripts to diagnose connectivity issues before troubleshooting deeper agent logic.