
sizla
io.github.NeoReader/sizla
Make short links and QR codes and read click stats from your AI assistant.
Documentation
siz.la developer docs
Documentation and examples for the siz.la REST API, webhooks and AI assistant connector. siz.la makes short links, QR codes and link-in-bio pages, and counts every click.
The pages also live at https://siz.la/docs. This repository is the same text, plus runnable examples and the machine-readable files.
Quick start
-
Sign in at siz.la and make an API key under Settings, then Developers.
-
Keep it in an environment variable:
export SIZLA_API_KEY="your key" -
Shorten a link:
curl -X POST "https://siz.la/api/url/add" \ -H "Authorization: Bearer $SIZLA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com/a/long/address","custom":"lunch-menu"}'{ "error": 0, "id": 1042, "shorturl": "https://siz.la/lunch-menu" }
What is here
| Folder or file | What it holds |
|---|---|
| docs/ | One page per topic: authentication, links, account, click export, conversions, webhooks, errors and rate limits, and the assistant connector with a page for each assistant |
| examples/ | Runnable scripts for every endpoint in cURL, Node.js, Python and PHP, and webhook receivers that check the signature |
| openapi.json | The OpenAPI 3.1 description, the same file as https://siz.la/openapi.json |
| mcp/server.json | The entry for the official MCP registry: a remote server at https://siz.la/mcp with OAuth sign-in |
| CHANGELOG.md | What changed on siz.la, newest first |
Use siz.la from an AI assistant
Add https://siz.la/mcp as a remote MCP server in Claude, ChatGPT, Cursor, VS Code or any client that supports them, then sign in and choose Allow. Steps for each are in docs/connector.md.
Keeping this repository current
Everything except this README, CONTRIBUTING, LICENSE, mcp/ and examples/webhooks/ is generated from the siz.la source, so changes to those files are overwritten on the next update. To fix a mistake, open an issue or a pull request and describe what is wrong. See CONTRIBUTING.md.
License
The documentation and examples are MIT licensed. See LICENSE.
No installation packages available.