apiVersion: v1 data: index.html: "\n\n
\n\n\nHerramienta CLI para gestionar la presencia en X y Reddit. Busca, puntúa y genera respuestas con IA usando el contenido del blog.
\n# Linux
X11\nsudo apt install xclip\n\n# Linux Wayland\nsudo apt install wl-clipboard\n\n
\ cd ze-promote\npip
install -r requirements.txt\n\n cp .env.example .env\n# Edita .env con tus
claves\n\n | Variable | Necesaria | Para qué |
|---|---|---|
| ANTHROPIC_API_KEY | Sí | Generar respuestas con Claude |
| GETX_API_KEY | No | Búsquedas en X/Twitter. Sin ella solo funciona Reddit |
bash install.sh\nsource
~/.bashrc # o ~/.zshrc si usas zsh\n Crea el alias ze
en tu shell y el ejecutable /usr/local/bin/ze. Después puedes usar
ze desde cualquier directorio.
Al arrancar sin flags, el programa hace tres cosas automáticamente:
\n\n \Cada resultado muestra: score, recomendación automática, fuente, autor, preview del contenido, estadísticas y fecha.
\n\n| Indicador | Condición | Por qué |
|---|---|---|
| ✅ Responder | \n \Score ≥ 40 y < 15 comentarios | \nPoca competencia, buena visibilidad garantizada | \n
| ⚠️ Opcional | \nScore ≥ 40 y 15-80 comentarios | \nPuede merecer la pena si el contenido encaja muy bien | \n
| ❌ Saltar | \nScore < 40, >80 comentarios o post de opinión | \n \Demasiado ruido o sin contexto factual para responder | \n
Los posts de opinión (\"what do you think\", \"¿qué pensáis?\", \"debate\", \"CMV\"…) se descartan automáticamente.
\n\nTras la tabla, el programa muestra cada post con su panel de detalle:
\n\n| Tecla | Acción |
|---|---|
| r | Generar respuesta con Claude |
| s | Saltar al siguiente resultado |
| q | Salir |
Al pulsar r, Claude genera una respuesta teniendo en cuenta:
\n \| Tecla | Acción |
|---|---|
| c | Copiar al portapapeles |
| e | Editar inline antes de copiar |
| s | Descartar y pasar al siguiente |
Tras copiar, el programa muestra exactamente dónde pegar la respuesta:
\n\n \Claude compara el tema concreto del post con los artículos publicados. Si hay solapamiento real, incluye la URL del artículo de forma natural. Si no hay coincidencia precisa, no incluye ningún link — una respuesta sin link es mejor que un link forzado.
\n \Para cuando encuentras algo interesante navegando manualmente — como cuando alguien te manda una captura de pantalla.
\n\n \ze --manual\n# o\nze -m\n\n | Flag | Descripción | Ejemplo |
|---|---|---|
| (sin flags) | Búsqueda completa en X y Reddit | ze |
--manual, -m | Pega texto directamente para generar respuesta | ze -m |
--no-twitter | Omitir búsquedas en X/Twitter | ze --no-twitter |
--no-reddit | Omitir búsquedas en Reddit | ze --no-reddit |
--limit
N, -n N | Mostrar solo los N mejores resultados | ze
-n 10 |
--help | Mostrar ayuda | ze
--help |
ze
--no-twitter # solo Reddit, útil sin GETX_API_KEY\nze --limit 15 #
ver solo el top 15\nze -m # modo manual\nze --no-reddit --limit
5 # solo los 5 mejores tweets\n Cada resultado recibe una puntuación de 0 a 100 basada en cuatro criterios:
\n\n| Criterio | Puntos | Detalle |
|---|---|---|
| Engagement | 0–40 | Likes + upvotes en escala logarítmica |
| Recencia | 0–30 | <6h → 30 · <24h → 22 · <48h → 12 · <72h → 5 |
| Idioma español | 0–20 | Detectado por palabras clave en el texto |
| Competencia baja | 0–10 | 0 replies → 10 · <5 → 7 · <15 → 4 · <40 → 1 |
Tweets con cero engagement en las tres métricas (likes, replies y retweets todos por debajo del umbral mínimo) se descartan antes de puntuar.
\nEdita ze_promote/sources.py para cambiar las
queries y subreddits:
# Queries
para X/Twitter (texto plano, sin operadores avanzados)\nTWITTER_QUERIES = [\n
\ \"UAP OVNI desclasificacion 2026\",\n \"OVNI España avistamiento\",\n \"UAP
disclosure Pentagon\",\n]\n\n# Subreddits y queries para Reddit\nREDDIT_SEARCHES
= [\n (\"UFOs\", \"UAP\"),\n (\"HighStrangeness\", \"UAP\"),\n (\"conspiracyespanol\",
\"OVNI\"),\n (\"es\", \"OVNI avistamiento\"),\n # añade más: (\"subreddit\",
\"query\")\n]\n\n ze-promote/\n├──
install.sh # Instalador del comando ze\n├── main.py # Punto
de entrada CLI\n├── ze_promote/\n│ ├── scraper.py # Scraping de zonadeexclusion.com\n│
\ ├── sources.py # Búsqueda en X y Reddit\n│ ├── scorer.py # Algoritmo
de scoring 0-100\n│ ├── responder.py # Generación de respuestas con Claude\n│
\ └── ui.py # Interfaz Rich (tabla, paneles, prompts)\n├── requirements.txt\n├──
.env.example\n└── README.md\n