📦 aim-trade-news — AIm-trade-news

外贸资讯查询

查询最近 1~3 天的外贸相关资讯，返回 AI 生成的标题和摘要。数据源为 AEP Gateway 的 trending_hub 服务。

何时使用

当用户要求：

查看最近的外贸动态、外贸新闻 了解进出口政策变化 获取国际贸易相关资讯 用户交互流程 用户询问外贸资讯（如"最近有什么外贸新闻"、"最近3天的外贸动态"） 代理 先运行自检确认凭证可用 调用脚本查询资讯 按格式化模板展示结果 使用前自检

每次使用前必须先跑自检：

python3 scripts/搜索_news.py --检查-config

配置d: true → 继续查询流程 配置d: false → 暂停，按下文"密钥配置"章节的 4 步引导用户配置凭证（无需用户自己改文件，代理 代写 .env），配好后重跑自检

注意：通过 JSON 输出的 配置d 字段判断状态，不看进程退出码。

技术流程

技能 不缓存数据、不写本地存储，只需要 AEP_AUTHORIZATION 一个凭证即可运行，每次查询都实时调用 AEP Gateway。

读取凭证 → AEP Gateway trending_hub API → 解析返回 → JSON 输出

从环境变量或 .env 读取 AEP_AUTHORIZATION 凭证 调用 https://aep.vemic.com/trending_hub/AI_collection，传 category: "foreign_trade" 和 recentDays 解析返回数据，提取 AITitle、summary、publishDate、url 等字段 以 JSON 格式输出 命令 # 查询最近 3 天（默认） python3 scripts/搜索_news.py

# 查询最近 1 天 python3 scripts/搜索_news.py --days 1

# 查询最近 2 天 python3 scripts/搜索_news.py --days 2

参数 参数 说明 默认值 --days 查询最近几天的资讯，仅支持 1、2、3 3 --检查-config 检查 AEP 凭证配置状态 — 输出格式

脚本输出 JSON：

{ "成功": true, "data更新Time": "2026-04-15 10:30:00", "dataSize": 15, "items": [ { "AITitle": "AI改写后的标题", "title": "原始标题", "publishDate": "2026-04-15", "url": "https://example.com/article", "summary": "AI生成的摘要内容" } ] }

如果返回 "成功": false，展示 message 字段中的错误信息。

展示格式

按以下格式展示每条资讯：

{序号}. {AITitle 或 title}

• 发布日期：{publishDate}
• AI摘要：{summary}
• 原文链接：查看原文

头部信息：

外贸资讯（最近 {days} 天）

如果返回 0 条资讯：最近 {days} 天暂无外贸资讯更新。

密钥配置

通过 AEP 网关调用 API，需要 AEP_AUTHORIZATION 凭证（Bearer 令牌 格式）。凭证存储在 技能 目录下的 .env 文件中（已 gitignore，不提交），脚本会自动补全 Bearer 前缀，只需填写 令牌 值。

配置流程（首次使用或自检 配置d: false 时）：

提示用户去 https://工具s.mentarc.cn/AIm-技能s/ 注册获取 AEP_AUTHORIZATION（Bearer 令牌）

用户把 令牌 粘到对话框里发给 代理（不让用户自己编辑文件或设置环境变量）

代理 把 令牌 写入 技能 目录下的 .env，格式：

AEP_AUTHORIZATION=<用户提供的令牌>

重跑 python3 scripts/搜索_news.py --检查-config 确认 配置d: true，再继续用户原请求

脚本内置的 load_dotenv() 自动读取 .env，环境变量优先于文件。更多约束（如跨 代理 禁止共享凭证）见 references/aep-设置up.md。

文件说明 文件 用途 scripts/搜索_news.py 主脚本：凭证检查 + 资讯查询 代理s/openAI.yaml 代理 接口定义（display_name、default_prompt） references/aep-设置up.md AEP 凭证配置指引 requirements.txt Python 依赖声明 .env 凭证文件（已 gitignore，不提交） 规则 展示时优先使用 AITitle（AI 改写标题），回退到 title（原始标题） 如果 API 请求失败，直接展示错误信息，不重试 API 请求超时 30 秒，超时后返回网络错误 技能 不缓存资讯数据，每次调用实时查询 API 查询范围仅限 1~3 天，不支持自定义时间范围 不适用于国内新闻、娱乐资讯、实时行情查询（汇率/股价）