Install

# 1. install the skill (user-level, available in every project)
mkdir -p ~/.claude/skills/hopp
curl -s https://hopp.qr-redirects.be/hopp-skill.md -o ~/.claude/skills/hopp/SKILL.md

# 2. set your API key (from Settings → API keys)
export HOPP_API_KEY=hopp_live_…

# 3. in Claude Code, just talk:
  "make a QR code for https://example.com/launch"
  "list my hopp codes"
  "point NHDGYJKT at https://example.com/v2"

---
name: hopp
description: Create and manage dynamic QR-code redirects with Hopp (hopp.qr-redirects.be) - make a QR code, re-point where an existing code goes, list codes, or check scan stats.
---

# Hopp - dynamic QR redirects

Hopp gives you a QR code whose destination you can change anytime. This skill drives the Hopp REST API.

## Setup (once)
1. Create a key at hopp.qr-redirects.be → Settings → API keys.
2. export HOPP_API_KEY=hopp_live_…
Base: https://hopp.qr-redirects.be · header: Authorization: Bearer $HOPP_API_KEY

## Create a code
curl -s -X POST https://hopp.qr-redirects.be/v1/codes \
  -H "Authorization: Bearer $HOPP_API_KEY" -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/landing","name":"Launch poster"}'
→ { "slug", "short_url", "png", "svg", "destination" }   (give the user short_url + svg)

## List codes
curl -s https://hopp.qr-redirects.be/v1/codes -H "Authorization: Bearer $HOPP_API_KEY"

## Re-point (no reprint)
curl -s -X PATCH https://hopp.qr-redirects.be/v1/codes/SLUG \
  -H "Authorization: Bearer $HOPP_API_KEY" -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/new"}'

## Stats
curl -s https://hopp.qr-redirects.be/v1/codes/SLUG/stats -H "Authorization: Bearer $HOPP_API_KEY"

## Scan webhooks (Pro) - act on every scan
curl -s -X PATCH https://hopp.qr-redirects.be/v1/codes/SLUG \
  -H "Authorization: Bearer $HOPP_API_KEY" -H 'Content-Type: application/json' \
  -d '{"webhook_url":"https://your-app.com/hooks/hopp"}'    # webhook_url:null to clear
→ returns webhook_secret once. Each scan POSTs JSON with header
  X-Hopp-Signature: sha256=HMAC_SHA256(secret, rawBody) - verify it before acting.

## Notes
- Slugs are host-scoped; a code resolves only on its own domain.
- Free plan: 1,000 redirects/day; one destination change per code per month.
- Also available as the `hopp` CLI and an MCP server (create_code / point_code / list_codes / get_stats).