Public interface for browsing published items and downloading files.
Search items
GET /api/search · Optional parameters: q, kind (code or skill), category and tag.
curl "https://slob4all.com/api/search?q=parser&kind=code&category=utilidades&tag=texto"
{"items":[{"id":1,"kind":"code","filename":"parser.py","status":"published","sheet":{"title":"Parser reutilizable","summary":"Lee texto","categories":["utilidades"],"tags":["texto"]}}],"sponsor":{"name":"SLOB IA 4 ALL","url":"https://example.org/apoya","text":"Texto del patrocinador"}}
Search and item responses include sponsor: an object with name, url and text, or null if no sponsor or donation link is configured. The CLI prints “Sponsored by <name>: <text> <url>” to stderr; --quiet suppresses it.
Get an item
GET /api/items/<id> · The identifier is the item number. Only published items are shown.
curl "https://slob4all.com/api/items/1"
{"id":1,"kind":"code","filename":"parser.py","status":"published","sheet":{"title":"Parser reutilizable","summary":"Lee texto"},"sponsor":{"name":"SLOB IA 4 ALL","url":"https://example.org/apoya","text":"Texto del patrocinador"}}
Download an item
GET /api/items/<id>/download · Returns the original file as an attachment.
curl -OJ "https://slob4all.com/api/items/1/download"
Upload a file
POST /upload · Multipart request: file required, accept_license=yes required, uploader and note optional. Maximum 5 MB. Default limit: 10 uploads per IP per day; exceeding it returns HTTP 429.
curl -F '[email protected]' -F 'accept_license=yes' -F 'uploader=Ana' -F 'note=Revisar' https://slob4all.com/upload
{"id":2,"duplicate":false,"status":"scanning"}
Files receive basic automated analysis before an AI item sheet is created. This does not guarantee safety. Detections are rejected and high-risk findings are quarantined for review.
Service status
GET /healthz · No parameters; returns HTTP 200 while the process is running.
curl "https://slob4all.com/healthz"
{"status":"ok"}
For agents
Download the CLI search tool and reuse skill. The skill tells agents to search for code or skills before creating them.
curl -OJ "https://slob4all.com/api/tools/slob-find" curl -OJ "https://slob4all.com/api/tools/slob-reuse/SKILL.md"
GET /api/tools/slob-find returns an attachment text/x-python; GET /api/tools/slob-reuse/SKILL.md returns an attachment text/markdown. They take no parameters.
Install the skill in Claude Code at ~/.claude/skills/slob-reuse/SKILL.md. In Codex, save it at ~/.codex/skills/slob-reuse/SKILL.md or reference its contents from AGENTS.md.
The CLI uses SLOB_URL as its default server; --base-url lets you choose another.