sn-search-social-en
Searches Reddit, Twitter, and YouTube to find what people are talking about.
Installation
Paste this into Claude Code, Cursor, or any agent that can run commands.
What this skill does
What it does: - Searches Reddit for posts and discussions about any topic - Searches Twitter and X for tweets about any topic - Searches YouTube for videos about any topic - Lets you pick how many results you want - Lets you filter by time period, category, or how popular something is When to use it: - You want to find what people are talking about on Reddit - You need to see recent tweets about a topic - You want to find YouTube videos about something - You are researching what people think about a subject - You want to see trending discussions on social media
SKILL.mdShow the author's original SKILL.md (not in English)
---
name: sn-search-social-en
description: 用于搜索英文社交平台，包括 Reddit 帖子、Twitter/X 推文和 YouTube 视频。
---
# sn-search-social-en - 英文社交平台搜索
## 凭证配置
API key、token 与 cookie 统一建议写在仓库根目录 `.env`（参考 `.env.example`），并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证；不要把真实密钥写入 skill payload、报告、日志或提交。
搜索 Reddit、Twitter/X、YouTube 三个英文社交平台。
## 可用脚本
| 脚本 | 平台 | 用途 | API 密钥 |
|------|------|------|---------|
| `reddit_search.py` | Reddit | 帖子和讨论搜索 | 无需 |
| `twitter_search.py` | Twitter/X | 推文搜索 | 需 `TIKHUB_TOKEN` |
| `youtube_search.py` | YouTube | 视频搜索 | 需 `YOUTUBE_API_KEY` |
## 依赖
首次运行或脚本提示缺库时，使用本技能的依赖清单安装到当前 Python 环境：
```bash
python3 -m pip install -r requirements.txt
```
不要在脚本内部自动安装依赖。若安装失败、网络不可用或包不可用，停止使用对应脚本并改用网页搜索，说明缺少依赖。
## 参数说明
### reddit_search.py
```bash
python3 scripts/reddit_search.py <query> [选项]
```
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `query` | 搜索关键词（必填） | — |
| `--limit`, `-n` | 返回结果数量 | 10 |
| `--subreddit`, `-r` | 限定子版块（如 `python`, `machinelearning`） | — |
| `--sort` | 排序方式：`relevance`, `hot`, `top`, `new`, `comments` | relevance |
| `--time`, `-t` | 时间范围：`hour`, `day`, `week`, `month`, `year`, `all` | all |
```bash
python3 scripts/reddit_search.py "machine learning projects" --limit 5
python3 scripts/reddit_search.py "async python" --subreddit python --sort top --time month --limit 5
```
### twitter_search.py
```bash
python3 scripts/twitter_search.py <query> [选项]
```
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `query` | 搜索关键词（必填） | — |
| `--limit`, `-n` | 返回结果数量 | 10 |
| `--token` | TikHub Token（也可通过 `TIKHUB_TOKEN` 环境变量设置，必填） | — |
```bash
python3 scripts/twitter_search.py "AI agents" --limit 10
python3 scripts/twitter_search.py "LLM" --token your_tikhub_token --limit 5
```
### youtube_search.py
```bash
python3 scripts/youtube_search.py <query> [选项]
```
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `query` | 搜索关键词（必填） | — |
| `--limit`, `-n` | 返回结果数量 | 10 |
| `--api-key` | YouTube API 密钥（也可通过 `YOUTUBE_API_KEY` 环境变量设置，必填） | — |
| `--order` | 排序方式：`relevance`, `date`, `viewCount`, `rating` | relevance |
```bash
python3 scripts/youtube_search.py "transformer explained" --limit 5
python3 scripts/youtube_search.py "python tutorial" --order viewCount --limit 10
```
## 输出格式
标准 JSON：`{"success": true, "query": "...", "provider": "reddit|twitter|youtube", "items": [...], "error": null}`
Ships with 5 supporting files:
- requirements.txt
- scripts/reddit_search.py
- scripts/search_utils.py
- scripts/twitter_search.py
- scripts/youtube_search.py
Mirrored from the author's public source. Install counts from the open skills registry.