hqman/qveris

Overview

This skill enables discovery and dynamic execution of external APIs and tools via the QVeris platform. It helps you find APIs by capability (weather, finance, search, translation, etc.) and run selected tools with structured parameters. Requires setting QVERIS_API_KEY in the environment before use.

How this skill works

Search by describing the capability you need; the skill returns matching tools ranked by metrics like success_rate and avg_execution_time. After selecting a tool, execute it by providing the tool_id, the search_id from the search results, and JSON-formatted parameters. The skill can output formatted results or raw JSON and enforces a maximum response size.

When to use it

• When you need to find an external API for a capability but don’t know specific providers
• To prototype integrations quickly by discovering and calling third-party tools
• For data retrieval tasks like weather, stock data, news, currency exchange, or geolocation
• When you want to compare candidate tools by success rate and execution latency
• To run ad-hoc queries against diverse APIs without writing provider-specific code

Best practices

• Describe capabilities in search queries (e.g., 'weather forecast API') rather than requesting specific data
• Review tool metadata (success_rate, avg_execution_time) before executing
• Always include the search_id returned by the search when executing a tool
• Limit params to the tool’s documented inputs and validate JSON before sending
• Set a reasonable --max-size to avoid truncated responses and prefer --json for debugging

Example use cases

• Find current weather or forecast providers for a given city, then fetch conditions with city and units parameters
• Search for stock market data APIs, compare options, and execute queries for price history or earnings
• Discover news or web search tools to pull recent articles matching a topic
• Locate translation or currency exchange APIs and call them with text or currency pairs
• Rapidly prototype third-party integrations without hardcoding provider endpoints