convez.ai
SkillIntegração & APIsIntermediário
colakang

FreeToday Skills

colakang/freetoday-skills

Encontra e resgata automaticamente ofertas de comida/bebida grátis perto de você

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que encontra ofertas e cupons de comida e bebidas gratuitas ou com desconto profundo próximo ao usuário, e resgata automaticamente via integração com sites de parceiros ou fornece códigos de voucher. Funciona em qualquer agente com capacidade de fazer requisições HTTP, com suporte opcional a automação de navegador para resgate sem intervenção.

Instalação

$npx convez-ai colakang/freetoday-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
skill-latest
Issues abertas
0
Contribuidores
1

Casos de uso

  • Descobrir cafés, refeições e bebidas gratuitas ou com desconto em tempo real
  • Resgatar automaticamente ofertas em sites de parceiros sem trabalho manual
  • Obter códigos de voucher para resgate rápido após verificação

Veredito

Skill bem executada que resolve um problema real (encontrar ofertas locais) com integração API simples e fallback gracioso. A arquitetura de playbooks remotos permite evolução sem reinstalação, mas depende da saúde contínua do serviço deal.echo365.ai — um risco operacional relevante para quem não controla a infraestrutura backend.

README

A tradução para o português deste README ainda está na fila.

freetoday

Star on GitHub Installs Active users License: AGPL-3.0 Version

An agent skill that finds today's free or deeply-discounted food & drinks near you and either redeems them for you automatically (driving the merchant's site) or hands you a voucher code to redeem yourself after a quick phone verification.

⭐ Found a free coffee through this? Star the repo and send it to a friend. Every star helps more partners come on board — which means more free stuff for everyone. Two seconds: star it and share https://freetoday.ai with someone who'd use it.

Works in any agent that can make HTTP requests — Claude Code, Claude Desktop, Codex, Cursor, OpenClaw, or your own. A browser-automation tool is optional: it's only needed for hands-free auto-redeem. Without one, the skill falls back to the code-handoff flow.

What this is

A thin instruction package (SKILL.md + references/). The deals catalog and the per-merchant redemption playbooks live behind an API at https://freetoday.ai, so merchant flows can change without you re-installing anything.

Install

The skill is just a folder of Markdown. "Installing" means putting that folder where your agent looks for skills.

Terminal agents (Claude Code, Codex, Cursor, OpenClaw) — one-liner auto-detects the right place:

curl -fsSL https://freetoday.ai/install.sh | sh

Claude Desktop / Claude.ai (no terminal) — the GUI can't run curl, so install by uploading the packaged skill instead:

  1. Download the skill zip: https://freetoday.ai/freetoday.zip (or grab it from GitHub Releases).
  2. In Claude, open Settings → Capabilities and turn on Code execution & file creation (skills require it).
  3. Go to Settings → Customize → Skills, click ➕ → Create skill → Upload a skill, and pick freetoday.zip. Claude reads SKILL.md and shows the name + description.
  4. Toggle it on. Trigger it in any chat with e.g. "any free coffee near me?".

The zip's root is the freetoday/ folder (with SKILL.md inside) — upload it as-is, don't unzip it first.

First-run note: the first time the skill calls freetoday.ai (to fetch deals or grab a code), Claude Desktop's sandbox may ask you to approve outbound access to that domain — just click Allow. It's a normal one-time prompt (enabled once Code execution is on), not an install error.

Or clone it yourself into the location your agent uses:

Claude Code

mkdir -p ~/.claude/skills
git clone https://github.com/colakang/freetoday-skills.git ~/.claude/skills/freetoday

Restart the session; trigger with e.g. "any free coffee near me?".

Codex (OpenAI Codex CLI / IDE)

Codex discovers project instructions through AGENTS.md. Clone the skill anywhere, then point Codex at it by referencing the path in your AGENTS.md (project root or ~/.codex/AGENTS.md for global):

git clone https://github.com/colakang/freetoday-skills.git ~/.codex/skills/freetoday
<!-- in AGENTS.md -->
## freetoday
When the user asks about free/discounted food or drink deals, follow the instructions
in ~/.codex/skills/freetoday/SKILL.md.

Cursor

git clone https://github.com/colakang/freetoday-skills.git ~/.cursor/freetoday

Add a rule under .cursor/rules/ that points at ~/.cursor/freetoday/SKILL.md, or paste the SKILL.md path into your project rules.

OpenClaw

git clone https://github.com/colakang/freetoday-skills.git ~/.openclaw/workspace/skills/freetoday

Any other agent

Drop the cloned folder wherever your agent auto-discovers skills, or just tell your agent to "read and follow <path>/SKILL.md". The skill only needs:

  • HTTP capability (curl, fetch, requests, an MCP HTTP tool — any one). Required.
  • A browser-automation tool (playwright-cli, camoufox-cli, Chrome MCP, or a built-in browse_url). Optional — only for auto-redeem.
  • File write under ~/.config/freetoday/ (one small UUID file).

What the skill does

  1. Asks for your ZIP or city, fetches matching deals.
  2. Asks how you want it: auto-redeem (it drives the merchant site) or just the code (you redeem yourself).
  3. Auto-redeem → walks a server-provided playbook in your browser, confirming with you before placing the order. Code handoff → verifies your phone with a one-time SMS code, then hands you the voucher code + steps.

Rate limit: one redemption per merchant per day, enforced server-side on your installation id + a hash of your phone + a device fingerprint. Deleting the local id file won't get you a second one.

Repo layout

SKILL.md                  entrypoint — workflow, the two redemption paths, executor
VERSION                   date-style version, sent as X-Skill-Version on every call
references/
  api-contract.md         every endpoint's request/response shape + status codes
  playbook-schema.md      step-action semantics + variable substitution
  browser-tool-mapping.md map actions → playwright-cli / camoufox-cli / Chrome MCP / browse_url
  merchants/cotti.md      Cotti-specific notes (Flutter Web app, CAPTCHA handoff)
evals/evals.json          trigger eval prompts

See also

  • Companion campaign: Cotti × OpenClaw NY Tech Week 2026 booth.

Spread the word

freetoday grows by word of mouth — no ads, no growth hacks. If it got you something free:

  • ⭐ Star this repo — it's the signal partners look at before they sign on.
  • 📣 Share it — send https://freetoday.ai to a friend, or post the deal you found.
  • 🛠️ Bring a merchant — if you run (or know) a spot that wants to give a little away, open an issue. New cities and merchants are how this gets useful outside NYC.

License

AGPL-3.0 — see LICENSE. Copyright (c) 2026 freetoday.ai. If you fork it or run a modified version as a network service, AGPL requires you to offer your corresponding source to that service's users.

Ver o original no GitHub

Bom para

Relacionados