Readme
Co AssetLog je
AssetLog je otevřená datová platforma pro lokální inzerci. Shromažďuje dynamická data z měst a obcí do jednoho strukturovaného balíku, ke kterému přistupuje jak člověk, tak AI přes veřejné API.
Platforma je globálního formátu, ale primárně se zaměřuje na lokální inzerci ve městech — tam, kde data vznikají a kde mají smysl.
Otevřená data
Jsme inzertní portál, který dělá pravý opak toho, co zbytek branže. Většina portálů zamyká své inzeráty za API, která nejdou číst, paywally, přes které se nedostaneš, které zakazují scrapování. AssetLog data otevírá — každý inzerát se publikuje přes veřejné, strojově čitelné API, doplněné o Schema.org JSON-LD, OpenAPI spec a llms.txt manuál pro AI agenty.
Záleží nám na transparentnosti a na tom, aby inzerent získal co největší dosah a co nejrychlejší prodej. Když si tvůj inzerát přečte ChatGPT, Claude, Perplexity i Google AI nativně, dosáhneš na publikum, na které žádný klasický inzertní portál nesahá — bez poplatků za premium pozice, bez sponzorovaných slotů, bez algoritmického gatekeepingu.
Cíl: šetřit AI tokeny
Data jsou po internetu chaoticky roztroušena. Pokaždé, když se AI pokusí najít inzerát, musí procházet desítky stránek, reklam, obrázků a skriptů — a za každý token platí čas i peníze.
Tohle je pokus scelit dynamická data do jednoho balíku. Místo scrapování tuctu portálů, AI zavolá jediný endpointy a dostane čistý, strojově čitelný JSON.
AI přes veřejné API umí:
- číst inzeráty (GET)
- vytvářet nové (POST)
- editovat existující (PATCH / PUT)
- mazat (DELETE)
Kategorie inzerce
- vehicle — auta, motorky, užitkové vozy
- real_estate — byty, domy, pozemky, komerční nemovitosti
- cv — profily kandidátů a životopisy pro uchazeče o práci
- job — pracovní nabídky a brigády
Viditelnost v AI modelech
Díky strukturovaným datům (Schema.org JSON-LD), veřejnému API a strojově čitelnému formátu mají inzeráty publikované přes AssetLog výrazně vyšší šanci, že je odcitují AI vyhledávače jako Perplexity, ChatGPT s web search a Google AI Overviews.
Místo aby AI tápala po zastrčených webech, má tady data připravená přesně v podobě, se kterou umí pracovat nativně. Inzerent tím získává dosah do nové vrstvy internetu — té, kde se uživatel neptá Googlu, ale AI asistenta.
Odeslání přes ChatGPT
Pro uživatele ChatGPT Plus: oficiální AssetLog GPT umožňuje přidávat vozidla, nemovitosti, životopisy nebo práci konverzačně. Stačí popsat, co chcete zveřejnit, a na e-mail vám přijde potvrzovací odkaz.
Pro Claude, Cursor, Cline a další MCP-kompatibilní klienty viz následující sekce. Gemini a Perplexity zatím přímý submit nepodporují — ale umějí číst a citovat inzeráty z AssetLogu přes náš veřejný feed a JSON-LD.
Fotky v AI inzerátech
Submit API přijímá fotky třemi nezávislými způsoby — klient si vybere ten, který odpovídá jeho možnostem:
- Veřejné URL obrázků (Imgur, CDN, zdrojový inzerát) v poli images endpointu /ai/submit.
- Nativní upload přes multipart/form-data na /ai/images/upload (vrátí veřejnou URL).
- JSON + base64 na /ai/images/upload (vrátí veřejnou URL).
Realita ChatGPT Custom GPT: spolehlivě nepředá fotky, které uživatel nahrál do chatu (/mnt/data/...), do svých Actions — ani jako multipart, ani jako base64. Model často pošle jen lokální cestu jako prostý text a upload selže. dnes je Nejspolehlivější postup je vložit do chatu veřejnou URL obrázku. AI klienti s nativním HTTP file API (Python skripty, n8n, Make, Claude API tool use) uploady zvládají bez problému.
Připoj Claude, Cursor a další AI klienty (MCP)
AssetLog provozuje MCP server (Model Context Protocol) na jedné stálé URL: https://api.assetlog.ai/mcp — standardní způsob, jak může AI asistent používat AssetLog jako nástroj přímo z chatu. Po připojení stačí říct "přidej můj byt" nebo "najdi Laravel vývojáře v Praze" a asistent jedná. Funguje s Claude Desktop, Claude Code, Cursor, Cline, Continue a libovolným dalším MCP klientem.
Nejjednodušší cesta: claude.ai Custom Connector (bez konfigurace)
Pokud máš Claude Pro / Max / Team / Enterprise na claude.ai, nejrychlejší cesta je vestavěný Custom Connector. Žádné tokeny, žádné config soubory, žádné CLI.
- Otevři claude.ai → Settings → Connectors → Add custom connector
- Vlož URL: https://api.assetlog.ai/mcp
- Klikni Add. Přihlas se do AssetLog, když budeš vyzván, a klikni Allow na consent obrazovce.
- Hotovo. Nástroje se objeví v Claude chatu — zkus "Use AssetLog to list my assets" nebo "Najdi auta v Brně".
Pod kapotou claude.ai používá OAuth 2.1 + Dynamic Client Registration (RFC 7591) — stejný standard, jaký bys použil pro integraci s libovolným moderním OAuth providerem. Žádné ruční sdílení tokenů, kdykoliv revokovatelné z connector page.
Funguje i pro ChatGPT (Custom Connector)
Plány ChatGPT Pro / Team / Enterprise / Edu podporují stejný MCP standard přes Custom Connectors — URL serveru AssetLogu je identické. Jeden backend, oba AI asistenti.
- Otevři chatgpt.com → Settings → Connectors → Add (nebo v chatu: + → Connectors)
- Vlož stejnou URL: https://api.assetlog.ai/mcp
- Autorizuj na AssetLog OAuth obrazovce. Tooly se objeví v ChatGPT — zkus „Vypiš moje AssetLog inzeráty" nebo „Podej můj životopis jako Laravel vývojář".
Uživatelé ChatGPT Free / Plus (zatím bez Connectors UI) mohou použít manuální token cestu níže přes Custom GPT (Action) — viz sekce Manuální setup.
Co může AI dělat (14 nástrojů)
Čtecí nástroje — AI může procházet veřejný feed i tvoje vlastní inzeráty:
- vyhledávání ve veřejném feedu (filtry: typ, město, cenové rozpětí, geo radius); detail jednoho inzerátu; seznam měst; statistiky platformy.
- výpis tvých vlastních inzerátů (rozpracované, aktivní, prodané) — užitečné před edit/delete, aby AI věděla, který inzerát myslíš.
- Tyhle fungují pro každého — read-only operace bez vedlejších efektů.
Zápisové nástroje — mění reálná data, chráněné tvým osobním tokenem:
- podání nového inzerátu — stejný email-confirmation flow jako přes web (před zveřejněním musíš kliknout v emailu).
- nahrání fotky — vrátí public URL, kterou AI připojí k inzerátu.
- úprava polí jednoho z tvých inzerátů (cena, stav, titulek, lokace, …) — partial update, mění se jen pole, která zmíníš.
- smazání tvého inzerátu — NEVRATNÉ. AI má v popisku instrukci slovně potvrdit s tebou před voláním, ale chovej se k tomu opatrně. Pokud chceš inzerát jen dočasně skrýt, požádej AI, aby ho označila jako expired.
Manuální setup (Claude Desktop / Claude Code / Cursor / Cline / Continue)
Pro klienty bez OAuth Custom Connectors UI (Claude Desktop, Claude Code CLI, Cursor, Cline, Continue, …) použijte osobní Bearer token. Stejný MCP server, jen jiný způsob autentikace.
Dvě cesty přihlášení pro vygenerování tokenu
Nepotřebuješ registraci s heslem. Pokud jsi v minulosti potvrdil AI-podaný inzerát, účet už existuje — přihlas se jednorázovým kódem z emailu (bez hesla) a token vygeneruj z dashboardu. Power useři s email + heslem můžou použít klasický login.
Tři kroky k připojení:
- Zaregistruj se nebo se přihlas na assetlog.ai a v hlavičce klikni connect_to_AI — vyber nejjednodušší cestu (Claude.ai Custom Connector nebo ChatGPT Connector), nebo si vygeneruj ruční token pro Claude Desktop / Cursor / Cline. Ruční token se ukáže jen jednou — chovej se k němu jako k heslu.
- Přidej AssetLog server do svého AI klienta. Dvě cesty: (a) Claude Code CLI — `claude mcp add --scope user --transport http assetlog https://api.assetlog.ai/mcp --header "Authorization: Bearer <TOKEN>"`; (b) edituj config soubor klienta (claude_desktop_config.json u Claude Desktop, ekvivalent u Cursoru / Cline / Continue) a přidej mcpServers blok s URL a Authorization hlavičkou. Po uložení klienta plně ukonči (Quit, ne jen close okna) a znovu spusť.
- Restartuj klienta. Asistent vidí 14 nástrojů (vyhledávání, detail, seznam měst, statistiky, podání, nahrání fotky, kontakt vlastníka) a používá je na vyžádání. Podané inzeráty stále projdou stejným email-confirmation flow — žádný asset nejde live bez tvého kliknutí.
Ztratil jsi token, měníš zaměstnání, rotuješ klíče? V dashboardu kterýkoliv token zruš — AI klient s ním okamžitě přestane fungovat.
Vize: AIX — AI Experience
Budoucnost není ve stále hezčím UI. Budoucnost je v AIX (AI Experience). UI a UX jsou jen rozptýlení, které bere uživateli čas.
AI nepotřebuje krásný frontend. AI potřebuje dobrá, kvalitní data. AssetLog je mezikrok k čistým datům — místo, kde data žijí ve formátu, kterému AI rozumí