search-for-service

Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches — search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".

3,891 stars
Complexity: easy

About this skill

The `search-for-service` skill enables an AI agent to interact with the x402 bazaar, a marketplace for paid API endpoints. It provides commands to search for services by keyword, list all available resources, and inspect the payment requirements of specific endpoints. This is crucial for agents needing to extend their capabilities beyond their inherent functions or other installed skills. Agents can use this skill to dynamically find and evaluate external APIs, understand what services are available, and identify potential tools to solve complex problems or fulfill user requests. It acts as a discovery mechanism, allowing the agent to explore a wide range of external services without requiring prior knowledge or authentication for the search process. Key use cases include responding to user queries like "what can I do?", "find me an API for X", or "browse the bazaar". It also serves as a robust fallback mechanism: if no other skill directly addresses a user's need, the agent can search the x402 bazaar to see if a paid service exists that could achieve the goal, thus increasing the agent's problem-solving versatility.

Best use case

The primary use case is for AI agents that need to dynamically discover and potentially integrate external API services to complete a user's request or solve a task that is outside their immediate capabilities. Developers and power users who leverage AI agents for complex problem-solving or automation will benefit most, as it expands the range of solutions the agent can propose and implement.

Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches — search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".

A list of relevant API services or detailed information about a specific service from the x402 bazaar, potentially including their descriptions and payment requirements.

Practical example

Example input

Find a paid API service on the x402 bazaar that can convert text to speech.

Example output

Searching x402 bazaar for 'text to speech'...
Results:
1. 'TextToSpeechPro' - Converts text to high-quality audio. (Details: npx awal@latest x402 details TextToSpeechPro)
2. 'VoiceSynth API' - Generates natural-sounding speech from input text. (Details: npx awal@latest x402 details VoiceSynthAPI)

When to use this skill

  • When a user asks for an API or service to perform a specific task.
  • When no other installed skill can clearly fulfill a user's request.
  • To explore and understand the range of paid API services available on the x402 marketplace.
  • To discover external services required to accomplish a complex task.

When not to use this skill

  • When the task can be fully completed using the agent's internal capabilities or existing integrated skills.
  • When the user explicitly states they do not wish to use external or paid services.
  • When the exact required API is already known and directly accessible.
  • For tasks that do not involve discovering or interacting with external API services.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/agnicpay-search-for-service/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/agnicpay-prog/agnicpay-search-for-service/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/agnicpay-search-for-service/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How search-for-service Compares

Feature / Agentsearch-for-serviceStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityeasyN/A

Frequently Asked Questions

What does this skill do?

Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches — search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".

How difficult is it to install?

The installation complexity is rated as easy. You can find the installation instructions above.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Searching the x402 Bazaar

Use the `npx agnic@latest x402` commands to discover and inspect paid API endpoints available on the x402 bazaar marketplace. No authentication or balance is required for searching.

## Commands

### Search the Bazaar

Find paid services by keyword using BM25 relevance search:

```bash
npx agnic@latest x402 bazaar search <query> [-k <n>] [--force-refresh] [--json]
```

| Option            | Description                          |
| ----------------- | ------------------------------------ |
| `-k, --top <n>`   | Number of results (default: 5)       |
| `--force-refresh` | Re-fetch resource index from CDP API |
| `--json`          | Output as JSON                       |

Results are cached locally at `~/.config/agnic/bazaar/` and auto-refresh after 12 hours.

### List Bazaar Resources

Browse all available resources:

```bash
npx agnic@latest x402 bazaar list [--network <network>] [--full] [--json]
```

| Option             | Description                             |
| ------------------ | --------------------------------------- |
| `--network <name>` | Filter by network (base, base-sepolia)  |
| `--full`           | Show complete details including schemas |
| `--json`           | Output as JSON                          |

### Discover Payment Requirements

Inspect an endpoint's x402 payment requirements without paying:

```bash
npx agnic@latest x402 details <url> [--json]
```

Auto-detects the correct HTTP method (GET, POST, PUT, DELETE, PATCH) by trying each until it gets a 402 response, then displays price, accepted payment schemes, network, and input/output schemas.

## Examples

```bash
# Search for weather-related paid APIs
npx agnic@latest x402 bazaar search "weather"

# Search with more results
npx agnic@latest x402 bazaar search "sentiment analysis" -k 10

# Browse all bazaar resources with full details
npx agnic@latest x402 bazaar list --full

# Check what an endpoint costs
npx agnic@latest x402 details https://example.com/api/weather
```

## Prerequisites

- No authentication needed for search, list, or details commands

## Next Steps

Once you've found a service you want to use, use the `pay-for-service` skill to make a paid request to the endpoint.

## Error Handling

Common errors:

- "CDP API returned 429" — Rate limited; cached data will be used if available
- "No X402 payment requirements found" — URL may not be an x402 endpoint
- No results — Try broadening the search query or using different keywords

Related Skills

tavily-search

3891
from openclaw/skills

Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.

Data & Research

baidu-search

3891
from openclaw/skills

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

Data & Research

Twitter Command Center (Search + Post)

3891
from openclaw/skills

Searches and reads X (Twitter): profiles, timelines, mentions, followers, tweet search, trends, lists, communities, and Spaces. Publishes posts after the user completes OAuth in the browser. Use when the user asks about Twitter/X data, social listening, or posting without sharing account passwords.

Social Media

openclaw-search

3891
from openclaw/skills

Intelligent search for agents. Multi-source retrieval with confidence scoring - web, academic, and Tavily in one unified API.

Data & Research

pay-for-service

3891
from openclaw/skills

Make paid requests to x402-enabled APIs using USDC. Use when you or the user want to call a paid API, make an x402 payment, use a bazaar service, or pay for an API request. Covers phrases like "call this API", "use this service", "pay for the request", "make a paid call", "fetch from x402 endpoint".

Web3 Payments & Services

search-cluster

3891
from openclaw/skills

Aggregated search aggregator using Google CSE, GNews RSS, Wikipedia, Reddit, and Scrapling.

Data & Research

alphashop-sel-product-search

3891
from openclaw/skills

商品搜索API SKILL:通过关键词搜索发现Amazon/TikTok平台商品。 支持价格、销量、评分、上架时间等多维度筛选条件。 通过 AlphaShop REST API 调用遨虾AI选品系统的商品搜索服务。

E-commerce & Product Sourcing

1688-product-search

3891
from openclaw/skills

1688商品搜索SKILL:提供完整的1688商品搜索能力,包括类目查询、关键词搜索、图片搜索、商品详情、相关性商品、拉取货盘底池等9个核心接口。 支持多语言搜索和商品推荐,使用1688开放平台官方API,统一鉴权,Token全局缓存共享。

E-commerce Sourcing

exa-web-search-free

3891
from openclaw/skills

Free AI search via Exa MCP. Web search for news/info, code search for docs/examples from GitHub/StackOverflow, company research for business intel. No API key needed.

Data & Research

duckduckgo-search

3891
from openclaw/skills

Performs web searches using DuckDuckGo to retrieve real-time information from the internet. Use when the user needs to search for current events, documentation, tutorials, or any information that requires web search capabilities.

Data & Research

monetize-service

3891
from openclaw/skills

Build and deploy a paid API that other agents can pay to use via x402. Use when you or the user want to monetize an API, make money, earn money, offer a service, sell a service to other agents, charge for endpoints, create a paid endpoint, or set up a paid service. Covers "make money by offering an endpoint", "sell a service", "monetize your data", "create a paid API".

Monetization & Resource Management

youtube-search

3891
from openclaw/skills

YouTube Search API via AIsa unified endpoint. Search YouTube videos, channels, and playlists with a single AIsa API key — no Google API key or OAuth required. Use this skill when users want to search YouTube content. For other AIsa capabilities (LLM, financial data, Twitter, web search), see the aisa-core skill.

Data & Research