{
  "name": "Snoffle",
  "description": "Checks whether people searching Google and AI assistants would find a product from its URL, and whether a buyer's agent would buy it; returns the Snoffle score with its three parts (readable, found, mentioned), a phone-visitor score, a would buy / would ask its human / would skip verdict, rivals, the honest call, plain-words fixes and a paste-ready prompt for a coding agent. For an Apify actor link, Snoffle grades the listing: readiness = the listing reads, found = store search finds it, traction = people use and rate it.",
  "url": "https://snoffle.broke2builtai.com",
  "provider": {
    "organization": "Broke to Built",
    "url": "https://broke2builtai.com"
  },
  "version": "0.3.2",
  "documentationUrl": "https://snoffle.broke2builtai.com/llms.txt",
  "documentation": [
    "https://snoffle.broke2builtai.com/llms.txt",
    "https://snoffle.broke2builtai.com/AGENTS.md",
    "https://snoffle.broke2builtai.com/SKILL.md",
    "https://snoffle.broke2builtai.com/openapi.json"
  ],
  "pricing": {
    "model": "paid",
    "currency": "USD",
    "plans": [
      {
        "id": "single",
        "name": "One report",
        "price": 9,
        "period": "once",
        "checkout": "self",
        "words": "one report"
      },
      {
        "id": "monthly",
        "name": "Starter",
        "price": 19,
        "period": "month",
        "checkout": "self",
        "words": "3 reports a month",
        "pass": true
      },
      {
        "id": "pro",
        "name": "Pro",
        "price": 49,
        "period": "month",
        "checkout": "self",
        "words": "12 reports a month",
        "pass": true
      }
    ],
    "passes": "A monthly pass is paid once for one month (31 days from payment) and holds its reports for any of your sites; nothing renews by itself, and buying another month adds a new key with its own reports.",
    "quote": {
      "id": "done",
      "name": "Have it done for you",
      "fromPrice": 499,
      "currency": "USD",
      "checkout": "none",
      "line": "Have it done for you: from $499 by fixed quote; we reply by email; nothing is charged until the price is agreed.",
      "request": "To request it: POST https://snoffle.broke2builtai.com/api/snoffle/ticket with JSON {\"email\": <where the person should reply>, \"message\": <what you want done>, \"site\": <the site>, \"kind\": \"done\"}. There is no checkout and no way to pay for it through the API."
    },
    "payTo": {
      "chain": "base",
      "chainId": 8453,
      "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "address": "0x7a3E312Ec6e20a9F62fE2405938EB9060312E334",
      "note": "Snoffle's receiving wallet is 0x7a3E312Ec6e20a9F62fE2405938EB9060312E334 (USDC on Base, chain 8453; also in /.well-known/agent.json and on /terms)."
    },
    "keyless": "Without a key, deep=0 is the free check: the plain-rules score and the top 3 problems, 3 a day per address (429, code free_cap). Any other check without a key or a paid quote answers 402 (400 for a missing or refused URL).",
    "key": "Keep the key: an agent sends it on every call, and in a browser it opens /account (what is left, every report, re-checks). A person can also sign in at /account with the email they paid with: Snoffle emails a 6-digit code (no password needed), and every key bought with that email is there. If a key is lost, email eli@broke2builtai.com with the payment's transaction id (the Base transaction hash, or PayPal's transaction id from your PayPal activity) and the key is looked up from it; an agent that paid in USDC can also repeat the paid call within 24 hours of the quote, which returns the same key.",
    "site": "A One report key is for one site: its hostname, where www. and the bare domain count as one, and any path on that hostname is the same site. For an Apify actor link, that key is for that one actor. A Starter or Pro key (a monthly pass) works on any of your sites and actors for its month, and a key from the retired eight-report pack works on any of them with no expiry; a re-check simply uses a report.",
    "refunds": "A run that fails or never delivers on our side gives its report back; if a report arrives late or a check fails, email eli@broke2builtai.com and it is re-run or refunded in full.",
    "machinePayment": {
      "status": 402,
      "method": "exact USDC quote on Base (chain 8453); pay the quote within 2 hours; a paid quote can be redeemed for 24 hours; The USDC amount is the price plus a unique fraction of a cent (under one cent) that identifies your payment; send exactly that amount. Before 3 confirmations it answers 409 `pending`; retry in a few seconds. The call that carries x-snoffle-quote and x-snoffle-tx waits for the report (about 90 seconds); keep the connection open. If it drops, repeat the same request with the same headers: while the first run can still deliver you get 409 `running` (it can stay running for up to 5 minutes; poll every retryAfterSeconds, at most 30 s), then the report: the saved one, or a new run if the first never delivered. A run that never delivers gives its report back, so you are never charged twice.",
      "humanFallback": "pay.paypal.url ($9, one report), pay.paypal.monthly ($19 a month) or pay.paypal.pro ($49 a month), paid with PayPal"
    },
    "deep": "A paid key runs the deep check by default. deep=0 is the plain-rules check: not charged, needs no report, limited to 10 a day per key (429, code rules_cap).",
    "cache": "The same URL checked in the last 12 hours returns the saved report, free for the key that already received it (`cached: true`); send fresh=1 after a deploy, which uses one report.",
    "runTime": "about 90 seconds",
    "example": "https://snoffle.broke2builtai.com/example/report"
  },
  "mcp": {
    "url": "https://snoffle.broke2builtai.com/mcp",
    "transport": "streamable-http",
    "protocolVersion": "2025-06-18",
    "auth": "Authorization: Bearer <key> (optional: without a key snoffle_check returns the ways to pay)",
    "tools": [
      {
        "name": "snoffle_check",
        "description": "Run Snoffle's deep check on a product URL and return the report: the Snoffle score and its parts, the verdict, the top fixes in plain words, the next fix, and the handoff prompt that applies every fix. With a key it uses one report ($9 each); a repeat within 12 hours is the saved report, free, and fresh: true skips it and uses one report. The same URL checked in the last 12 hours returns the saved report, free for the key that already received it (`cached: true`); send fresh=1 after a deploy, which uses one report. The call waits for the report (about 90 seconds). Without a key it runs nothing and returns pay: an exact USDC-on-Base quote and PayPal links for a human. If the same check is already running for this key it returns code \"running\" with retryAfterSeconds: wait, then call again at no extra cost."
      },
      {
        "name": "snoffle_pay_usdc",
        "description": "After sending exactly pay.usdc.amount (or pay.usdcMonthly.amount, pay.usdcPro.amount) in USDC on Base to its address, redeem the payment: Snoffle verifies it on-chain, mints your key and runs the report in the same call (about 90 seconds). The USDC amount is the price plus a unique fraction of a cent (under one cent) that identifies your payment; send exactly that amount. Before 3 confirmations it answers 409 `pending`; retry in a few seconds. The call that carries x-snoffle-quote and x-snoffle-tx waits for the report (about 90 seconds); keep the connection open. If it drops, repeat the same request with the same headers: while the first run can still deliver you get 409 `running` (it can stay running for up to 5 minutes; poll every retryAfterSeconds, at most 30 s), then the report: the saved one, or a new run if the first never delivered. A run that never delivers gives its report back, so you are never charged twice."
      },
      {
        "name": "snoffle_status",
        "description": "Snoffle's prices, how to pay, the rules a key follows, and whether the deep check is switched on. Free; runs nothing."
      }
    ],
    "about": "Snoffle is also a remote MCP server at https://snoffle.broke2builtai.com/mcp (Streamable HTTP, protocol 2025-06-18). Tools: snoffle_check {url, fresh?} runs the deep check and waits for the report (about 90 seconds, with progress every 15 seconds; a 409 running comes back as a tool result with retryAfterSeconds); snoffle_pay_usdc {url, plan, quote, tx} redeems a paid USDC quote and returns the report and the key; snoffle_status gives the prices and the rules. Send the key as an Authorization: Bearer header (or x-snoffle-key, or the tool's key argument). Without a key snoffle_check runs nothing and returns the ways to pay. A check takes about 90 seconds, longer than the 60 seconds many MCP clients wait by default: in Claude Code set MCP_TOOL_TIMEOUT=180000 (in the shell before starting claude, or under \"env\" in settings.json); other clients, raise their tool timeout to 180 seconds.",
    "pay": "Over MCP: after paying, call snoffle_pay_usdc with the same url, the plan you paid (single = pay.usdc, monthly = pay.usdcMonthly, pro = pay.usdcPro), the quote and the transaction hash. It waits for the report and returns your key in access.key; keep it and send it as the Authorization: Bearer header from then on.",
    "timeout": "A check takes about 90 seconds, longer than the 60 seconds many MCP clients wait by default: in Claude Code set MCP_TOOL_TIMEOUT=180000 (in the shell before starting claude, or under \"env\" in settings.json); other clients, raise their tool timeout to 180 seconds.",
    "noHeaders": "Clients that can't set headers (for example the Claude app's connectors) can pass your key as the `key` argument.",
    "config": {
      "mcpServers": {
        "snoffle": {
          "type": "http",
          "url": "https://snoffle.broke2builtai.com/mcp",
          "headers": {
            "Authorization": "Bearer snf_your_key"
          }
        }
      }
    }
  },
  "authentication": {
    "required": true,
    "schemes": [
      "x-snoffle-key header",
      "Bearer"
    ],
    "keyFormat": "keys look like snf_…",
    "obtain": "pay the 402 quote, or a human pays by PayPal"
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/check",
      "description": "Check a product page. Query: url (required), deep, fresh (1 = a new check, skipping the saved report from the last 12 hours; uses one report). A paid key runs the deep check by default. deep=0 is the plain-rules check: not charged, needs no report, limited to 10 a day per key (429, code rules_cap). 402 with payment options when no key. Takes about 90 seconds."
    },
    {
      "method": "POST",
      "path": "/api/check",
      "description": "Same, JSON body {url, deep, fresh}."
    },
    {
      "method": "GET",
      "path": "/api/status",
      "description": "Service status and prices."
    },
    {
      "method": "POST",
      "path": "/mcp",
      "description": "Snoffle is also a remote MCP server at https://snoffle.broke2builtai.com/mcp (Streamable HTTP, protocol 2025-06-18). Tools: snoffle_check {url, fresh?} runs the deep check and waits for the report (about 90 seconds, with progress every 15 seconds; a 409 running comes back as a tool result with retryAfterSeconds); snoffle_pay_usdc {url, plan, quote, tx} redeems a paid USDC quote and returns the report and the key; snoffle_status gives the prices and the rules. Send the key as an Authorization: Bearer header (or x-snoffle-key, or the tool's key argument). Without a key snoffle_check runs nothing and returns the ways to pay. A check takes about 90 seconds, longer than the 60 seconds many MCP clients wait by default: in Claude Code set MCP_TOOL_TIMEOUT=180000 (in the shell before starting claude, or under \"env\" in settings.json); other clients, raise their tool timeout to 180 seconds."
    },
    {
      "method": "POST",
      "path": "/api/snoffle/ticket",
      "description": "Reach a person. Have it done for you: from $499 by fixed quote; we reply by email; nothing is charged until the price is agreed. To request it: POST https://snoffle.broke2builtai.com/api/snoffle/ticket with JSON {\"email\": <where the person should reply>, \"message\": <what you want done>, \"site\": <the site>, \"kind\": \"done\"}. There is no checkout and no way to pay for it through the API."
    }
  ],
  "errorCodes": {
    "bad_url": {
      "status": 400,
      "what": "no url, a URL that is not public http(s), or a body that is not JSON"
    },
    "not_an_actor": {
      "status": 400,
      "what": "an apify.com link that is not an actor"
    },
    "invalid": {
      "status": 402,
      "what": "the key is not valid or has expired"
    },
    "used_up": {
      "status": 402,
      "what": "the key has used every report it came with"
    },
    "other_site": {
      "status": 402,
      "what": "this One report key is for a different site; a report on this one needs its own key (a Starter or Pro key works on any site)"
    },
    "quote": {
      "status": 402,
      "what": "the quote id is unknown or too old (pay the quote within 2 hours; a paid quote can be redeemed for 24 hours); ask for a new one"
    },
    "used": {
      "status": 402,
      "what": "that payment was already redeemed"
    },
    "bad_hash": {
      "status": 402,
      "what": "x-snoffle-tx is not a transaction hash"
    },
    "failed": {
      "status": 402,
      "what": "the transaction failed on-chain"
    },
    "too_old": {
      "status": 402,
      "what": "the transaction predates the quote"
    },
    "late": {
      "status": 402,
      "what": "the payment was sent after the quote expired"
    },
    "amount_mismatch": {
      "status": 402,
      "what": "the USDC amount is not exactly the quote"
    },
    "not_to_us": {
      "status": 402,
      "what": "the transaction did not send USDC to the quoted address"
    },
    "pending": {
      "status": 409,
      "what": "seen on Base, not yet 3 confirmations; retry in a few seconds"
    },
    "rpc": {
      "status": 409,
      "what": "Base RPCs did not answer; retry in a minute"
    },
    "unknown": {
      "status": 402,
      "what": "no transaction with that hash on Base yet; wait a few seconds and retry"
    },
    "running": {
      "status": 409,
      "what": "this check is already running for this key; it takes about 90 seconds, then the same call returns it at no extra cost"
    },
    "unreadable": {
      "status": 422,
      "what": "the page could not be read (blocked, empty, not HTML, or SnoffleBot is disallowed); tell your human what it returned, do not guess a score"
    },
    "rules_cap": {
      "status": 429,
      "what": "this key has used its 10 uncharged plain-rules checks today; send deep=1 (uses a report)"
    }
  },
  "skills": [
    {
      "id": "check",
      "name": "Find-and-buy check",
      "description": "The Snoffle score (overall) and its parts (readiness, found, traction), a phone-visitor score (visitors), a converts-customers score (converts), a would buy / would ask its human / would skip verdict, rivals, the honest call, ranked fixes, and a prompt that applies them."
    }
  ]
}