Receitas

Rastreador de Vagas

Acompanhe novas vagas em uma agenda e notifique quando aparecerem

Monitore um conjunto de páginas de carreiras e notifique (Slack / e-mail / Discord) quando uma nova vaga que combine com seu filtro for publicada. O mesmo padrão funciona para imóveis, anúncios de marketplace ou qualquer sinal de "novo item apareceu".

Schema

{
  "type": "object",
  "properties": {
    "title":       { "type": "string", "description": "Job title" },
    "department":  { "type": "string" },
    "location":    { "type": "string", "description": "City or 'Remote'" },
    "url":         { "type": "string", "description": "Canonical job posting URL" },
    "postedAt":    { "type": "string", "description": "ISO-8601 timestamp if shown" }
  },
  "required": ["title", "url"]
}

Fluxo

  1. Em uma agenda (cron / GitHub Actions), envie URLs de páginas de carreiras para /batch/extract
  2. Receba o Webhook na conclusão
  3. Faça diff contra a última execução — emita notificações para novas entradas (url)
  4. Filtre por palavras-chave de título / localização antes de notificar

Esboço de implementação

import httpx, json, pathlib

API = "https://openapi.thunderbit.com/openapi/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}
STATE = pathlib.Path("seen.json")

careers = [
    "https://example.com/careers",
    "https://example.org/jobs",
]

job = httpx.post(f"{API}/batch/extract",
                 headers=H,
                 json={"urls": careers, "schema": SCHEMA}).json()
# Poll or webhook (see Batch Job Lifecycle guide)

seen = set(json.loads(STATE.read_text())) if STATE.exists() else set()
new = []
for r in job["data"]["results"]:
    if r["status"] != "SUCCEEDED": continue
    for item in r.get("data", []):
        if item["url"] not in seen:
            new.append(item)
            seen.add(item["url"])

STATE.write_text(json.dumps(list(seen)))
notify(new)  # your Slack / email / Discord hook

Dicas

  • Persista as URLs já vistas em seen entre execuções — sem isso, cada execução notifica a lista inteira
  • Filtre agressivamente: if "Engineer" in item["title"] and "Remote" in item["location"]
  • Execute a cada 4-6 horas — páginas de carreiras não mudam minuto a minuto

Relacionados

Esta receita está sendo expandida com um template de workflow para GitHub Actions — volte em breve.