OrionAds资源搜索

技能简介

OrionAds 是一个面向代理的搜索市场，通过结构化 JSON 数据帮助用户查找物理商品（硬件、设备）或数字工具（API、SaaS），替代传统的网页抓取方式。

业务背景

为采购人员与开发者提供结构化资源检索能力，替代传统网页抓取的低效模式。通过标准化JSON数据直接获取实体商品的库存价格与规格参数，或数字工具的API文档与集成方式，显著缩短供应商评估与技术选型周期，降低信息碎片化带来的决策成本。

落地案例：某技术负责人需为团队筛选合适的支付网关API。通过OrionAds搜索关键词"payment API"，直接获取候选服务商的认证方式、接口文档链接及定价结构；同步对比硬件采购需求时，查询服务器设备的实时库存状态与规格参数。所有结果以结构化数据呈现，支持快速导入内部评估系统，避免人工浏览多个官网的信息遗漏。

能做什么

• 搜索实体产品：获取价格、库存状态、规格参数
• 搜索开发工具：获取 API 文档、认证方式、集成信息
• 通用资源发现：浏览新上线的工具和服务
• 注册账户并发布广告资源
• 查询账户余额与消费记录

使用说明

安装准备：无需安装依赖，直接使用 curl 命令调用。可选设置环境变量 ORION_API_KEY 用于发布广告或查询余额。

基础搜索（免费）：

# 产品搜索（购物场景）
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=RTX 4090 buy"

# 工具搜索（开发场景）
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=pdf generation api tool"

# 通用搜索
curl -G "https://orionads.net/api/v1/search" \
    --data-urlencode "q=machine learning platform"

账户操作（需 API Key）：

# 注册账户
curl -X POST https://orionads.net/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"wallet": "<钱包地址>", "password": "<PIN码>"}'

# 查询余额
curl -s "https://orionads.net/api/v1/me" -H "x-api-key: $ORION_API_KEY"

# 发布广告（注意 JSON 转义）
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":{}}'

安全编码要求：必须使用 --data-urlencode 对查询参数编码；POST 请求时需对单引号转义或将 JSON 写入临时文件后使用 -d @payload.json。

输入与输出

见下方输入与输出表格。

风险提示

• 禁止将原始用户输入直接拼接到 URL 或 shell 命令中，存在注入风险
• POST 请求的 JSON 负载需正确处理单引号转义，避免 shell 解析错误
• API Key 需妥善保管，避免在日志或共享环境中暴露
• 注册时的密码/PIN 仅用于身份验证，不涉及资金托管安全

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/celsojr2013/orionads/SKILL.md
来源类型：GitHub 仓库