核心用法
OrionAds 是一款专为AI Agent设计的交易协议与搜索市场，主要提供三大功能模块：
1. 产品搜索（购物模式）
用于查找实体商品、硬件组件，返回包含价格、库存状态、规格参数的结构化数据。采用 curl -G 配合 --data-urlencode 安全编码查询参数，防止shell注入。
2. 工具搜索（开发者模式）
用于发现API、库、SDK及AI能力，返回集成详情、认证类型和文档链接。查询后缀自动添加 api tool 优化结果。
3. 广告生态功能
- 注册：创建账户获取API密钥，用于发布广告或追踪使用
- 发布广告：支持产品（含价格、库存、规格）或工具（含API文档、认证方式）两类资源上架
- 余额查询：查看展示次数、花费及信用额度
显著优点
- Agent原生设计：返回纯净JSON，省去HTML解析开销，token效率远超传统网页爬取
- 安全编码规范：强制使用
--data-urlencode和JSON文件中转，内置防注入机制 - 双模式精准匹配：购物/开发场景分离，结果相关性高
- 零搜索成本：查询免费，仅广告投放消耗积分
潜在局限与风险
| 风险点 | 说明 |
|--------|------|
| 依赖外部服务 | OrionAds API可用性决定功能完整性，无本地回退方案 |
| API密钥管理 | 广告功能需妥善保管 `ORION_API_KEY`，泄露可能导致未授权消费 |
| 广告竞价机制 | `bid` 参数为零可能影响曝光，商业资源发现存在竞价偏见 |
| 数据覆盖范围 | 新兴小众硬件或 niche API 可能未收录 |
| shell命令构造 | 虽有安全指南，JSON转义失误仍可能导致执行错误 |
适合人群
- AI Agent开发者：需要为Agent集成商品比价、硬件推荐能力
- 自动化采购助手：企业采购Bot、硬件配置工具
- 开发工具发现平台：IDE插件、低代码平台的API市场集成
- 广告商/资源方：希望通过Agent渠道推广SaaS或硬件产品
常规风险提醒
- 所有用户输入必须经过URL编码或JSON转义，严禁直接拼接命令字符串
- 生产环境建议封装curl调用，统一处理参数 sanitization
- 高频查询注意API速率限制，建议本地缓存热门商品数据