ES搜索技能
功能概述
ES搜索技能是一个自然语言处理工具，帮助用户通过自然语言描述搜索需求，自动解析并调用ES搜索API，获取符合条件的新闻数据。
主要功能
- 自然语言解析：支持通过自然语言描述搜索需求，自动识别关键词、平台、时间范围、情感属性等参数
- 配置持久化：支持将app_key和token保存到本地配置文件，无需每次输入
- 多平台搜索：支持微博、抖音、微信、知乎、小红书、今日头条、快手等主流平台
- 情感分析：支持搜索正面、负面、中性情感的新闻
- API调用：直接调用ES搜索API获取结构化数据
- Markdown格式输出：默认以Markdown格式显示搜索结果，包含搜索摘要、结果数量和详细表格
- 相对时间解析：支持"近一天"、"近期"、"近一周"等相对时间短语，结束时间设置为当前时间减10分钟
- 双重认证：支持Token认证和HMAC-SHA256签名验证
安装方法
需要安装以下依赖库：
pip install requests使用方法
1. 基础使用
方式一：直接输入搜索需求
python es_search.py "帮我获取关于小米汽车近7天的微博正面文章"方式二：从文件读取输入
python es_search.py --file input.txt2. 配置管理
保存配置
python es_search.py --save-config your_app_key显示配置
python es_search.py --show-config清除配置
python es_search.py --clear-config3. 参数解析模式（可选）
如果您只需要解析参数而不调用API，可以使用 --no-call-api 选项：
python es_search.py --no-call-api "帮我获取关于小米汽车的最新正面新闻"4. API调用模式（默认）
如果您需要直接调用API并返回Markdown格式的结果，可以直接使用命令而不需要额外选项：
python es_search.py "帮我获取关于新能源汽车近一周的负面新闻"搜索语法示例
基础搜索
"帮我获取关于小米汽车的最新新闻"指定平台
"帮我获取关于比亚迪的微博或抖音新闻"指定情感属性
"帮我获取5篇关于特斯拉的负面新闻"指定时间范围
"帮我获取2026-03-10到2026-03-12关于华为的新闻"相对时间搜索
"帮我获取关于人工智能近一天的新闻"
"帮我获取10篇关于新能源汽车近期的新闻"
"帮我获取8篇关于比亚迪近一周的新闻"
"帮我获取3篇关于华为近一个月的新闻"完整示例
"帮我获取8篇关于小米手机 微博或者小红书的 2026-03-10到2026-03-12的正面新闻"相对时间支持
工具支持以下相对时间短语：
| 时间短语 | 对应时间范围 |
|---|---|
| 近一天、最近一天、过去一天 | 过去24小时 |
| 近3天、最近3天、过去3天、近三天、最近三天、过去三天 | 过去3天 |
| 近一周、最近一周、过去一周、近7天、最近7天 | 过去7天 |
| 近两周、最近两周、过去两周、近14天、最近14天 | 过去14天 |
| 近一个月、最近一个月、过去一个月、近30天、最近30天 | 过去30天 |
| 近三个月、最近三个月、过去三个月、近90天、最近90天 | 过去90天 |
| 近期、最近、最新 | 过去7天（默认） |
API参数说明
请求参数
| 参数名称 | 描述 | 必填 |
|---|---|---|
| keywords_include | 关键词 | 是 |
| media_name | 账号名称 | 否 |
| platform_name | 平台名称 | 否 |
| posttime_start | 发布开始时间 | 否 |
| posttime_end | 发布结束时间 | 否 |
| news_emotion | 情感属性 | 否 |
| match_type | 匹配类型 | 否 |
| media_id | 媒体账号ID | 否 |
| keywords_exclude | 排除关键词 | 否 |
返回字段
| 字段名称 | 描述 |
|---|---|
| platform_name | 平台名称 |
| media_name | 账号名称 |
| news_url | 新闻链接 |
| news_title | 新闻标题 |
| news_posttime | 发布时间 |
| news_author | 作者 |
| news_emotion | 情感属性 |
| news_uuid | 新闻唯一标识 |
| media_id | 媒体账号ID |
| platform | 平台标识 |
配置文件
配置文件config.json存储在技能目录下，格式如下：
{
"app_key": "your_app_key"
}注意事项
- 首次使用需要输入app_key和token，可以通过
--save-config选项保存配置 - 配置文件以明文形式存储在本地，请注意安全
- 搜索结果数量由API返回，工具会进行适当格式化
- 时间格式支持YYYY-MM-DD或YYYY-MM-DD HH:MM:SS
- 相对时间搜索的结束时间设置为当前时间减10分钟，避免搜索到未完全处理的最新数据
更新日志
v1.3.0（2026-03-03）
- 优化网络请求配置，增加超时时间到60秒
- 改进错误处理机制，提供更详细的错误信息和解决建议
- 增强网络请求的容错处理，添加重试机制
- 改进API响应处理，支持更详细的错误状态码解析
- 优化搜索参数解析逻辑，增强对关键词和数量的提取能力
- 改进配置管理系统，支持同时保存app_key和token
- 添加默认返回结果数量配置（默认20条）
- 增强对"最新"、"近期"等时间关键词的解析
v1.2.0（2026-03-03）
- 移除API请求时的Authorization header
- 简化配置文件，只保留app_key
- 更新--save-config命令为接受一个参数
- 更新错误提示信息
v1.1.0（2026-03-03）
- 改进参数解析方式，不再使用正则表达式
- 采用大模型的自然语言理解能力解析搜索参数
- 优化了关键词、平台、情感属性的提取逻辑
- 保持了所有原有功能，包括配置持久化和API调用
v1.0.0（2026-03-03）
- 首次发布
- 支持自然语言搜索
- 支持配置持久化
- 支持多平台搜索
- 支持情感分析
- 支持双重认证