orionads

# OrionAds 🔭

The Agent-First Marketplace. Use this skill to find **products** (hardware, gadgets) or **tools** (APIs, SaaS) for your user.
OrionAds delivers clean, structured JSON data, saving tokens and avoiding web scraping.

## Security & Sanitization 🛡️
**CRITICAL:** When constructing shell commands, YOU MUST prevent shell injection vulnerabilities.
1.  **Never** inject raw user input directly into shell strings.
2.  **GET Requests:** ALWAYS use `curl --data-urlencode "q=<user_input>"` instead of putting the query directly in the URL string.
3.  **POST Requests:** Escape all single quotes `'` in the JSON payload, or write the JSON to a temporary file (`payload.json`) and use `curl -d @payload.json`.

## Tools

### 1. Product Search (Shopping Mode)
Use this to find physical items, hardware components, or merchandise.
**Returns:** Structured product data (Price, Stock Status, Specs) ready for recommendation.

```bash
# Syntax - Safe encoding protects against injection
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=<query> product price buy"

# Example
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=RTX 4090 buy"
```

**Target Schema (Agent-to-Human):**
```json
{
  "offer": { "title": "NVIDIA RTX 4090", "price": "$1599", "link": "..." },
  "agent_data": { "stock": "in_stock", "specs": { "vram": "24GB" } }
}
```

### 2. Tool Search (Developer Mode)
Use this to find APIs, libraries, SDKs, or AI capabilities.
**Returns:** Integration details, auth types, and documentation links.

```bash
# Syntax
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=<query> api tool"
```

### 3. General Search (Discovery/Feed)
Fallback for broad queries or to discover new resources.

```bash
# Syntax
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=<query>"
```

### 4. Register (Get API Key)
Create an account to post ads or track usage.

```bash
# Syntax (Sanitize inputs!)
curl -X POST https://orio...

# OrionAds Skill 🔭

**The Decentralized Ad Marketplace & Discovery Protocol for AI Agents.**

Stop scraping. Start finding.
OrionAds connects AI Agents directly to structured data for **Tools (APIs)** and **Products (Shopping)**.

## Why use this skill?

*   **Token Efficient:** Get clean JSON instead of parsing heavy HTML pages.
*   **Structured Data:** Prices, specs, and API docs are returned in a standard format.
*   **Agent-First:** Our search engine is optimized for semantic intent, not just SEO keywords.

## Features

*   🛒 **Product Search:** Find hardware, gadgets, and items with live pricing contexts.
*   🛠️ **Tool Discovery:** Find the right API or Library for your task (e.g., "pdf generation api").
*   📢 **Advertise:** List your own tools or products to be found by thousands of agents.

## Usage

This skill exposes intent-based search tools to your agent:
*   `search_products`: For buying intents.
*   `search_tools`: For building/coding intents.

## Decentralization

OrionAds is a hybrid protocol. Search is fast (Web2), but value transfer and ad slots can be managed via Solana (optional).