reddit-research

Skill de Investigación en Reddit

Enrutamiento integral de investigación en Reddit a través de los métodos más confiables. Sabes exactamente qué herramientas funcionan, cuáles no, y cuándo usar cada una.

Disparadores

/reddit-research analyze r/homelab engagement
/reddit-research what subs does u/example_user post in
/reddit-research find deleted posts in r/SUBNAME
/reddit-research discover subreddits about topic X
search reddit for discussions about X
check reddit metrics for these subreddits

---

Clasificación de métodos — una ruta funciona, el resto están muertos

Re-evaluado 2026-09-19. Arctic Shift es la única fuente funcional. Todo lo demás está bloqueado. La siguiente escalera no es una cadena de respaldo elegante; tres de sus cuatro peldaños han desaparecido, y el modo de falla que importa es sustituir silenciosamente un peldaño muerto con búsqueda web y presentar el resultado como datos de Reddit.

Ruta	Estado 2026-09-19	Evidencia
API de Arctic Shift	FUNCIONA — la única	curl .../api/posts/search?subreddit=selfhosted → 200, objetos de publicación completos
reddit.com .json a través de curl	MUERTO — 403	bloqueo a nivel de entorno; User-Agent de navegador no ayuda
WebFetch / WebSearch en reddit.com	MUERTO	WebSearch devuelve 400 dominios no accesibles
Playwright en old.reddit.com	NO DISPONIBLE	necesita el servidor MCP de Playwright, que falla rutinariamente al conectar

Arctic Shift — la ruta principal y, en la práctica, la única

• Base: https://arctic-shift.photon-reddit.com/api
• curl simple. Sin autenticación, sin navegador, sin muro proof-of-work.
• Ve publicaciones eliminadas, borradas y filtradas por spam — lo único que ninguna otra ruta puede hacer.

Úsalo para todo: investigación histórica, métricas, actividad de usuario, reglas, tono, recuperación de contenido eliminado.

Cuatro trampas que arruinarán silenciosamente una ejecución. Todas verificadas con llamada en vivo.

1. Los nombres de los parámetros no son obvios y las suposiciones incorrectas dan error grave. Texto completo usa title= o selftext= en /posts/search, y body= en /comments/search. q devuelve {"error":"Unknown query parameter: 'q'"}. sort solo acepta asc/desc.
2. {"error":"Timeout. Maybe slow down a bit"} devuelto en menos de un segundo es un LÍMITE DE TASA, no una consulta lenta. Cuatro llamadas sin pausa son suficientes para activarlo. Reintentar con un -m más largo o una ventana más estrecha no hace nada. Pausa ~4s entre llamadas, y retroceder exponencialmente (8→120s) ante ese error.
3. Ante cualquier error la respuesta es {"data":null,...}. El código que accede directamente a json.data.length falla con la respuesta de límite de tasa en lugar de informarlo. Verifica que data no sea nulo antes de tocarlo, y muestra error cuando esté presente.
4. Las publicaciones más recientes de ~36h llevan hide_score:true y score:1 — filtrarlas antes de calcular cualquier métrica, o los números son ficción. No hay ordenación por puntuación: obtén muchos datos y ordena del lado del cliente.

Cuando Reddit realmente no puede responder

Si la pregunta necesita clasificaciones en vivo, recuento actual de suscriptores o una vista autenticada, Arctic Shift no puede servirla y no hay nada más disponible. Dilo en el informe. No permitas que un flujo de trabajo devuelva cero sentimiento y se lea como "nada encontrado" — dos ejecuciones de investigación anteriores consumieron 206 agentes sin producir datos de Reddit antes de que se diagnosticara esto.

Estos sustitutos están verificados como funcionales y son la alternativa honesta para "qué dicen los profesionales", siempre que etiquetes la fuente como no-Reddit:

• Hacker News (mejor sustituto): https://hn.algolia.com/api/v1/search?query=<términos>&tags=story (o &tags=comment), luego https://hn.algolia.com/api/v1/items/<objectID> para el árbol de comentarios completo. Exige que cada cita lleve su ID de comentario y vuelve a obtenerla para confirmar que la cadena existe.
• Lobsters: https://lobste.rs/search?q=<términos>&what=stories&order=relevance
• Stack Exchange: https://api.stackexchange.com/2.3/search/advanced?order=desc&sort=votes&q=<términos>&site=stackoverflow

---

Métodos que no funcionan — nunca intentar

Método	Por qué	Resultado
curl / WebFetch a reddit.com (cualquier ruta, incl. .json)	bloqueo a nivel de entorno; un User-Agent de navegador no lo evita	403
WebSearch con site:reddit.com o allowed_domains:["reddit.com"]	dominio no permitido	400 dominios no accesibles
RSS de Reddit (.rss) a través de curl	bloqueado específicamente	403
oauth.reddit.com sin token	redirige a HTML	301 → HTML
Espejos redlib / safereddit / libreddit	Intersticial proof-of-work de Anubis, necesita JS	página de desafío, 0 publicaciones
api.pullpush.io (sucesor de Pushshift)	caído	502
proxy r.jina.ai frente a old.reddit.com	proxy devuelve 200 que envuelve el propio 403 de Reddit	cuerpo 403

No desperdicies una ejecución redescubriendo estos. Si Arctic Shift no puede responder, nada aquí puede.

---

Referencia de API

Endpoints, campos de respuesta y las trampas para ambas fuentes: references/api.md. Léelo antes de construir una llamada; no reconstruyas un endpoint de memoria.

Métricas de Engagement

Las Cuatro Métricas (calcular a partir de datos de Arctic Shift)

Métrica	Fórmula	Mide
Ratio comentarios/votos (cmtRatio)	avgCmts / avgScore	Profundidad de discusión
Ratio de votos positivos	campo upvote_ratio (0-1)	Aprobación de la comunidad
Comentarios promedio por publicación	sum(num_comments) / count	Nivel de actividad
Puntuación promedio por publicación	sum(score) / count	Alcance/visibilidad

Cálculo

const posts = data.data.filter(p => !p.hide_score && p.score > 1);
const avgScore = posts.reduce((s, p) => s + p.score, 0) / posts.length;
const avgCmts = posts.reduce((s, p) => s + p.num_comments, 0) / posts.length;
const cmtRatio = avgCmts / avgScore;
const avgUpvoteRatio = posts.reduce((s, p) => s + p.upvote_ratio, 0) / posts.length;

Niveles de Profundidad de Discusión

Nivel	Umbral	Significado
S	>= 0.70	Altamente conversacional
A	>= 0.25	Discusión fuerte
B	>= 0.10 o cmts promedio >= 10	Moderado, vale la pena interactuar
C	0.05-0.10	Mayormente pasivo / sub de alcance
D	< 0.05	Bajo engagement
E	cmts promedio < 1	Muerto o con puerta dura

---

Evaluación de Tono

Evaluar a partir de datos de publicación ya obtenidos (sin llamadas adicionales):

1. Valores de link_flair_text — días temáticos, categorías, indicadores explícitos
2. Patrones de título — estilo de lenguaje, normas
3. selftext en publicaciones con mayor puntuación — señales culturales
4. Distribución de puntuaciones — lo que la comunidad realmente recompensa

Ordena las publicaciones obtenidas por puntuación del lado del cliente. Las 10-20 principales revelan los valores de la comunidad.

---

Flujos de trabajo estándar

Una receta de llamadas mínimas por solicitud recurrente — investigar un subreddit, investigar un usuario, encontrar hilos, descubrir subs, verificación por lotes, recuperar publicaciones eliminadas, detectar un shadowban: references/workflows.md.

Diagrama de decisión

¿Necesitas datos de Reddit?
|
+-- Publicaciones históricas, comentarios, métricas, actividad de usuario, reglas, contenido eliminado?
|     --> Arctic Shift. Esta es cada pregunta que el skill puede realmente responder.
|
+-- Rankings en vivo, recuento actual de suscriptores, o una vista autenticada?
|     --> NO DISPONIBLE. reddit.com es 403 para curl y WebFetch; WebSearch
|         rechaza el dominio; Playwright necesita un servidor MCP que usualmente está caído.
|         Dilo en el informe. No sustituyas búsqueda web silenciosamente.
|
+-- ¿Verificación de shadowban?
|     --> NO DISPONIBLE por la misma razón (necesitaba /user/NAME/about.json).
|
+-- "¿Qué dicen los profesionales sobre X?", donde Reddit era solo el medio?
|     --> HN Algolia / Lobsters / Stack Exchange, etiquetado como no-Reddit.
|
+-- ¿Publicar, comentar, MDs, modmail?
      --> No es posible a través de herramientas de investigación. Usa la interfaz de Reddit.

La regla de la brecha honesta: una pregunta que este skill no puede responder se reporta como irrespondible, con la razón. Una ejecución que devuelve cero datos de Reddit y no dice por qué se lee como "nada encontrado", que es una afirmación diferente y falsa.

---

Límites de Alcance

• Este skill es de SOLO LECTURA. Sin publicar, comentar ni operaciones de escritura.
• Si la tarea requiere publicar o acciones de cuenta, informa al usuario que debe hacerse a través de la interfaz de Reddit o un cliente autenticado.