Show JSON
{
"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.",
"author": "CyberMax",
"wellKnownURI": "https://tellwren.cybermax-tools.workers.dev/.well-known/agent-card.json",
"url": "https://tellwren.cybermaxtools.com/",
"version": "1.0.0",
"provider": {
"organization": "CyberMax",
"url": "https://cybermaxtools.com/"
},
"documentationUrl": "https://tellwren.cybermaxtools.com/llms.txt",
"iconUrl": null,
"supportsAuthenticatedExtendedCard": null,
"security": [
{},
{
"licenceKey": []
},
{
"licenceQuery": []
}
],
"securitySchemes": {
"licenceKey": {
"in": "header",
"name": "x-licence",
"type": "apiKey",
"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": {
"in": "query",
"name": "key",
"type": "apiKey",
"description": "Same key as a query parameter."
}
},
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false,
"extensions": null
},
"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"
]
}
],
"conformance": true,
"conformance_errors": null,
"homepage": null,
"repository": null,
"license": null,
"pricing": null,
"contact": null,
"id": "bf6f9b65-ac0f-4af0-8577-ac7704107da2",
"category": "data-analytics",
"category_secondary": null
}