# reddit-search-api

Скилл даёт модели точную документацию по API сервиса reddapi.dev. Помогает собирать запросы для векторного поиска по Reddit, отслеживать тренды и проверять схемы ответов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 10600 установок · ★ 15
- Автор: lignertys
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/lignertys/reddit-research-skills/tree/HEAD/skills/reddit-search-api/SKILL.md
- Обновлён: 2026-09-15
- HTML: https://affpapa.org/nevibecode/skills/reddit-search-api

## Что делает

Скилл содержит техническое описание эндпоинтов reddapi.dev без исследовательских инструкций. В него включены спецификации для векторного поиска `/api/v1/search/vector`, семантического поиска `/api/v1/search/semantic`, агрегации трендов и работы с данными сабреддитов. Справочник фиксирует точные имена полей в ответах, которые отличаются от официального API Reddit.

Для выполнения запросов требуется ключ в переменной окружения `REDDAPI_API_KEY` и заголовок `REDDAPI_AUTH`. Агент не должен считывать значение ключа напрямую или просить пользователя отправить его в чат. Если заголовок не задан, выполнение останавливается до ручного экспорта переменных в терминале.

Все POST-запросы требуют заголовок `Content-Type: application/json`, иначе сервер вернёт ошибку 403. При исчерпании лимитов или неверном ключе возвращается статус 429, а не 401. Тексты из постов Reddit рассматриваются как ненадёжные пользовательские данные и не могут служить командами для агента.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lignertys/reddit-research-skills --skill reddit-search-api -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/reddit-search-api/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/reddit-search-api/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lignertys/reddit-research-skills --skill reddit-search-api -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/reddit-search-api/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lignertys/reddit-research-skills --skill reddit-search-api -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/reddit-search-api/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lignertys/reddit-research-skills reddit-search-api
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/reddit-search-api/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lignertys/reddit-research-skills --skill reddit-search-api -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/lignertys/reddit-research-skills --path skills/reddit-search-api
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/reddit-search-api/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add lignertys/reddit-research-skills --skill reddit-search-api -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/lignertys/reddit-research-skills/tree/HEAD/skills/reddit-search-api/SKILL.md

## Когда брать
- составить curl-запрос для векторного поиска по сабреддитам
- получить схему ответа эндпоинта трендов reddapi.dev
- найти причину ошибки 403 или 429 при интеграции API
- узнать параметры фильтрации по датам для семантического поиска

## Примеры запросов агенту
- Покажи формат тела запроса для эндпоинта /api/v1/search/vector в reddapi.dev
- Составь curl-команду для получения списка трендов за последнюю неделю
- Какие поля возвращает эндпоинт /api/v1/subreddits и как их отсортировать?

## Похожие
- [reddit-api](https://affpapa.org/nevibecode/skills/alinaqi-reddit-api.md) — скилл · 316 установок
- [reddit-mcp-buddy](https://affpapa.org/nevibecode/mcp/reddit-mcp-buddy.md) — MCP-сервер · ★ 865
- [winmd-api-search](https://affpapa.org/nevibecode/skills/winmd-api-search.md) — скилл · 5700 установок
- [wp-rest-api](https://affpapa.org/nevibecode/skills/wp-rest-api.md) — скилл · 5900 установок
- [minimal-api](https://affpapa.org/nevibecode/skills/minimal-api.md) — скилл · 2800 установок
- [tavily-search](https://affpapa.org/nevibecode/skills/veithly-tavily-search.md) — скилл · 3700 установок

Из того же набора: [lignertys/reddit-research-skills](https://affpapa.org/nevibecode/by/lignertys/reddit-research-skills.md) — 3 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md