# Source Setup Reference

> Quick setup guide for each data source used by run-research.

- Skill: `tools-only/source-setup-reference` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/source-setup-reference`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/source-setup-reference/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/source-setup-reference

---

# Source Setup Reference

Quick setup guide for each data source used by run-research.

---

## Reddit — `reddit-cli`

Requires a free Reddit API app (script type, read-only).

1. Create app: https://www.reddit.com/prefs/apps → "create another app" → select "script"
2. Add credentials to `~/.secrets`:
   ```bash
   export REDDIT_CLIENT_ID="your_client_id"
   export REDDIT_CLIENT_SECRET="your_client_secret"
   ```
3. Verify: `reddit-cli auth`

Install: `pip install reddit-cli` (from `~/repos/myrepos/reddit-cli`)

---

## X / Twitter — `bird`

Uses your existing browser session — no API key needed.

1. Install: `brew install bird` or follow https://github.com/steipete/bird
2. Be logged into x.com in Safari or Chrome
3. Verify: `bird --whoami`

If cookie auth fails, set manually:
```bash
export AUTH_TOKEN=your_auth_token   # from browser dev tools → Application → Cookies → x.com
export CT0=your_ct0_token
```

---

## YouTube — `yt-dlp` + `yt_research.py`

1. Install yt-dlp: `brew install yt-dlp` or `pip install yt-dlp`
2. The `yt_research.py` script is bundled with the claudest `search-youtube` plugin:
   `~/.claude/plugins/cache/claudest/claude-utilities/0.1.4/skills/search-youtube/scripts/yt_research.py`
3. Verify: `yt-dlp --version`

---

## Web Search — brave-search + brave-cli (placeholder)

**Current** (brave-search skill):
- Requires `BRAVE_API_KEY` in `~/.secrets`
- Get key: https://api.search.brave.com
- Add: `export BRAVE_API_KEY="your_key"` to `~/.secrets`
- Script: `~/.claude/skills/brave-search/scripts/search.mjs`

**Planned** (brave-cli — in progress):
- Will be a standalone binary at e.g. `~/repos/myrepos/brave-cli`
- Same interface as `reddit-cli`: `brave-cli search "<query>" --output json`
- When built, update the PLACEHOLDER comment in `SKILL.md` Step 2 → Web Search

**Fallback**: Claude's native `WebSearch` tool is always available when `BRAVE_API_KEY` is not set.