联合搜索技能

目的

提供跨多个平台的统一搜索能力，支持 20+ 个平台的内容搜索和数据获取。所有搜索脚本遵循标准化的输入/输出约定，提供可靠、可读的结果。

何时使用此技能

• - 跨多个平台搜索内容（GitHub、Reddit、社交媒体、搜索引擎）
• 按时间范围、互动指标或内容类型过滤结果
• 批量搜索/下载并归档原始响应
• 需要无 API 密钥的搜索方案

可用的搜索工具

所有脚本位于 scripts/ 目录，每个模块都有详细的 README 文档。

开发者与社区搜索

社交媒体与网络搜索

注意: 火山引擎的图片搜索功能已集成到 unionimagesearch 模块

通用搜索引擎（无需 API 密钥）

其他搜索工具

快速开始

1. 配置凭据

在项目根目录创建 .env 文件（参考 ENV_TEMPLATE.txt）：

CODEBLOCK0

详细配置指南: 参考 API 凭据获取指南

2. 执行搜索

所有脚本支持类似的命令行参数：

CODEBLOCK1

3. 查看结果

• - 终端输出: 格式化的 Markdown 表格
• 原始响应: 保存在 responses/ 目录（使用 --save-raw 参数）

使用工作流

标准搜索流程

1. 1. 运行前: 验证 .env 配置存在且包含有效凭据
2. 运行: 从技能目录直接执行脚本
3. 运行后: 检查终端输出和 responses/ 目录中的原始响应文件

通用参数

大多数工具支持以下参数：

• - --limit / -n: 返回的结果数量
• INLINECODE9: JSON 格式输出
• INLINECODE10: 格式化 JSON 输出
• INLINECODE11: Markdown 格式输出
• INLINECODE12 / --output: 保存输出到文件
• INLINECODE14: 保存原始 API 响应到 responses/ 目录

最佳实践

结果过滤:

• - 使用 --limit 控制输出量
• 应用时间过滤器获取最新内容
• 按互动指标排序以找到热门内容

响应管理:

• - 永远不要将完整的原始 JSON 粘贴到对话中
• 需要完整数据访问时引用 responses/ 文件
• 使用 grep/jq 从保存的响应中提取特定字段

多平台搜索:

• - 为不同平台依次运行脚本
• 使用保存的响应文件比较跨平台结果

参考文档

详细的配置、限制和问题排查信息，请参考 references/ 目录：

• - API 凭据获取指南 - 如何获取各平台的 API 凭据
• 速率限制说明 - 各平台的速率限制和配额信息
• 平台特定说明 - 各平台的特殊说明和注意事项
• 问题排查指南 - 常见问题的诊断和解决方案
• Google 搜索技巧 - Google 搜索高级指令速查

常见问题速查

项目结构

CODEBLOCK2

配置优先级

所有工具支持三种配置方式（优先级从高到低）：

1. 1. 命令行参数: --token YOUR_TOKEN 或 INLINECODE22
2. 环境变量: 在项目根目录的 .env 文件中配置
3. 配置文件: 工具特定的配置文件（如 GitHub 的 ~/.github-search.json）

获取帮助

• - 模块文档: 每个模块都有详细的 README（scripts/*/README.md）
• 参考文档: 查看 references/ 目录中的详细指南
• 命令行帮助: 使用 --help 参数查看脚本用法
• 项目 README: 查看 README.md 了解项目概览