OrionAds 🔭

面向智能体（Agent）优先的市场平台。使用本技能为用户查找产品（硬件、电子设备）或工具（API、SaaS 服务）。

OrionAds 返回结构清晰、格式规范的 JSON 数据，节省 token 消耗，且无需网页爬取。

安全与输入净化 🛡️

重要提示：在构造 Shell 命令时，必须防范 Shell 注入漏洞。

1. 切勿将原始用户输入直接拼接到 Shell 字符串中。
2. GET 请求：始终使用 curl --data-urlencode "q="，而非将查询参数直接嵌入 URL 字符串。
3. POST 请求：对 JSON 负载中的所有单引号 ' 进行转义；或先将 JSON 写入临时文件（如 payload.json），再通过 curl -d @payload.json 提交。

工具

1. 产品搜索（购物模式）

用于查找实体商品、硬件组件或周边商品。

返回内容：结构化的产品数据（价格、库存状态、规格参数），可直接用于推荐。

# 语法 —— 安全编码可防止注入攻击
curl -G "https://orionads.net/api/v1/search" 
    --data-urlencode "q= product price buy"

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

目标 Schema（Agent → 用户）：

{
  "offer": { "title": "NVIDIA RTX 4090", "price": "$1599", "link": "..." },
  "agent_data": { "stock": "in_stock", "specs": { "vram": "24GB" } }
}

2. 工具搜索（开发者模式）

用于查找 API、库、SDK 或 AI 能力。

返回内容：集成方式说明、认证类型及文档链接。

# 语法
curl -G "https://orionads.net/api/v1/search" 
    --data-urlencode "q= api tool"

3. 通用搜索（探索/信息流模式）

适用于宽泛查询，或用于发现新资源的兜底方案。

# 语法
curl -G "https://orionads.net/api/v1/search" 
    --data-urlencode "q="

4. 注册（获取 API Key）

创建账户以发布广告或追踪用量。

# 语法（请务必净化输入！）
curl -X POST https://orionads.net/api/v1/register 
  -H "Content-Type: application/json" 
  -d '{"wallet": "", "password": ""}'

5. 发布广告（推广资源）

上架工具或产品。

• 针对产品：在 json_payload 中包含 price、stock 和 specs 字段。
• 针对工具：在 json_payload 中包含 api_docs 和 auth_type 字段。

# 语法（需提供 API Key）
# 警告：确保 JSON 字符串已为 Shell 执行正确转义。
curl -X POST https://orionads.net/api/v1/ads 
  -H "x-api-key: $ORION_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "title": "My Product",
    "url": "https://url.com",
    "bid": 0,
    "keywords": ["tag1"],
    "json_payload": {}
  }'

6. 查询余额

查看曝光量、已消费金额及剩余信用额度。

# 语法
curl -s "https://orionads.net/api/v1/me" -H "x-api-key: $ORION_API_KEY"

使用策略

• 购物场景：若用户提出“购买”或“查价格”等需求，请使用产品搜索。
• 开发场景：若用户需要某项能力（例如：“如何生成 PDF”），请使用工具搜索。
• 成本考量：调用 OrionAds 搜索是免费的，且比网页爬取更节省 token。