pnclFEED Clave gratuita

Notas de quickstart

Ejecuta el script de sondeo en un contenedor Docker

Una imagen pequeña, la clave pasada en tiempo de ejecución y una política de reinicio: el camino más corto del portátil a un poller sin supervisión.

El script de sondeo funciona en tu portátil. La siguiente pregunta es cómo ejecutarlo en algún lugar que no sea tu portátil, y la respuesta fiable y aburrida es un contenedor: una imagen pequeña, la clave inyectada en tiempo de ejecución, una política de reinicio para los días malos. Aquí está todo el montaje, construido sobre el quickstart de Python, verificado el 2026-10-27.

La imagen

El poll.py del quickstart necesita Python y una biblioteca, así que la imagen tiene cuatro líneas:

FROM python:3.12-slim
RUN pip install requests
COPY poll.py /app/poll.py
CMD ["python", "/app/poll.py"]

Constrúyela una vez, y el mismo artefacto corre en cualquier host con Docker: docker build -t odds-poll . desde la carpeta que contiene poll.py y el Dockerfile.

Fíjate en lo que no está en la imagen: la clave. Nada de la API pertenece a una capa de build, porque las imágenes se suben, se comparten y se cachean en lugares que tú no controlas.

La clave entra en tiempo de ejecución

El script ya lee su clave y la URL base del entorno, que es exactamente donde un contenedor las quiere. Pásalas al ejecutar y nunca tocarán un archivo de la imagen:

services:
  poll:
    build: .
    restart: unless-stopped
    environment:
      - ODDS_BASE_URL=https://...
      - ODDS_API_KEY=tu clave

Dos líneas hacen el trabajo operativo. Las entradas de entorno inyectan la clave y la URL base en tiempo de ejecución, y la política de reinicio trae el contenedor de vuelta tras un fallo o un reinicio del host. Para un poller, unless-stopped es la política correcta: reinicia en fallo y en el arranque, y aún respeta un stop deliberado. Un docker compose up -d lo inicia.

Los registros son la interfaz

Un contenedor desacoplado es invisible hasta que preguntas. docker compose logs -f sigue los prints del script, lo que en el quickstart significa cada money line movida en el momento en que llega. Eso basta para un montaje de vigilancia. Cuando quieras las cuotas en lugar de la consola, dale un volumen al contenedor y deja que el script escriba su CSV ahí, para que los datos sobrevivan al contenedor del que vinieron.

Si cambias el script, reconstruye y recrea: docker compose build, luego docker compose up -d otra vez. El ciclo es rápido porque la imagen es pequeña, y pequeña es una virtud aquí: menos capas, menos sorpresas, reinicios más rápidos.

Lo que el presupuesto de la clave gratuita significa dentro de un contenedor

Nada cambia en la permisión. La guía de cadencia del quickstart sigue aplicando: una llamada cada pocos segundos agota las 100 llamadas diarias de la clave gratuita en minutos, y un sondeo de 15 minutos estira el mismo presupuesto a lo largo de un día, como observa el quickstart, verificado el 2026-10-27. El contenedor cambia dónde corre el script, nunca con qué frecuencia debe llamar.

Ajusta el intervalo a la clave que tienes, no al host que alquilaste. El contenedor encantado superará tu cuota todo el día; el Dockerfile no conoce tu plan.

Un script, una imagen de cuatro líneas, dos variables de entorno y una política de reinicio. Ese es el salto completo de "funciona en mi máquina" a "corre sin mí".