{
  "protocolVersion": "0.3.0",
  "name": "Tellwren by CyberMax",
  "description": "Tellwren identifies an everyday object from a photo, a name or a barcode and returns its cited story (Wikipedia, Open Food/Beauty/Products Facts). Free daily photo scans and lookups per visitor, no key; a Tellwren Pro licence key raises the limits.",
  "url": "https://tellwren.cybermaxtools.com",
  "preferredTransport": "HTTP+JSON",
  "version": "1.0.0",
  "provider": {
    "organization": "CyberMax",
    "url": "https://cybermaxtools.com"
  },
  "documentationUrl": "https://tellwren.cybermaxtools.com/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "securitySchemes": {
    "licenceKey": {
      "type": "apiKey",
      "in": "header",
      "name": "x-licence",
      "description": "Tellwren Pro licence key (https://tellwren.cybermaxtools.com/pricing.json). Optional: the free tier needs no key and has a daily limit per visitor."
    },
    "licenceQuery": {
      "type": "apiKey",
      "in": "query",
      "name": "key",
      "description": "Same key as a query parameter."
    }
  },
  "security": [
    {},
    {
      "licenceKey": []
    },
    {
      "licenceQuery": []
    }
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "identify_photo",
      "name": "Identify an object from a photo",
      "description": "POST /api/identify with the photo bytes (JPEG, PNG or WebP, up to 1.5 MB) as the body returns the top guesses for what the object is (one Workers AI vision call; the photo is never stored). Free: a few scans a day per visitor; Pro key: more.",
      "tags": [
        "object identification",
        "barcode lookup",
        "product facts",
        "image recognition",
        "wikipedia"
      ],
      "examples": [
        "POST /api/identify (image/jpeg body)"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "object_story",
      "name": "Cited story for an object",
      "description": "GET /api/story?q=<name>&kind=<optional kind> searches the cited sources and returns the object's story, or candidates to pick from when unsure; GET /api/story?title=<Wikipedia title>&bc=<optional barcode> returns the story for one title.",
      "tags": [
        "object identification",
        "barcode lookup",
        "product facts",
        "image recognition",
        "wikipedia"
      ],
      "examples": [
        "https://tellwren.cybermaxtools.com/api/story?q=moka%20pot",
        "https://tellwren.cybermaxtools.com/api/story?title=Rubik%27s%20Cube"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "barcode_lookup",
      "name": "Barcode to product facts",
      "description": "GET /api/barcode?bc=<EAN/UPC digits> returns the product name and facts from Open Food Facts, Open Beauty Facts or Open Products Facts (no AI).",
      "tags": [
        "object identification",
        "barcode lookup",
        "product facts",
        "image recognition",
        "wikipedia"
      ],
      "examples": [
        "https://tellwren.cybermaxtools.com/api/barcode?bc=3017620422003"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://tellwren.cybermaxtools.com",
      "transport": "HTTP+JSON"
    },
    {
      "url": "https://tellwren.cybermax-tools.workers.dev",
      "transport": "HTTP+JSON"
    }
  ],
  "x-pricing": "https://tellwren.cybermaxtools.com/pricing.json"
}