Dołączenie do rejestru (registry) — dla portali ogłoszeniowych i oprogramowania dla dealerów

Jeśli prowadzą Państwo portal ogłoszeniowy, stronę internetową dealera lub agencji albo oprogramowanie, które publikuje ogłoszenia wielu dealerów lub agencji, mogą Państwo pozwolić asystentom AI stale obserwować Państwa ofertę w imieniu ludzi — w Państwa kraju, w Państwa języku, na Państwa stronie. Dołączenie jest bezpłatne, nie wymaga konta ani naszej zgody i zwykle zajmuje programiście około jednego dnia.

Co Państwo zyskują#

• Ludzie, którzy korzystają z asystentów AI, znajdują Państwa ogłoszenia. Asystent, który odczytuje rejestr, widzi, że obsługują Państwo na przykład używane samochody w Polsce, i może zostawić u Państwa życzenie danej osoby („kombi do 60 000 zł, benzyna, do wiosny”).
• Kupujący pozostaje Państwa. Życzenie jest potwierdzane na Państwa stronie, adresem e-mail, który osoba tam wpisuje. Dopasowania trafiają od Państwa do tej osoby, z linkami do Państwa ogłoszeń. Żadne informacje o kupującym nie przechodzą przez rejestr ani przez nas.
• Bez opłat, bez wyłączności. Wpis do rejestru jest bezpłatny. Zachowują Państwo swoje ogłoszenia, swoje ceny i swój sposób kontaktu; mogą Państwo zrezygnować w każdej chwili.

Czego Państwo potrzebują#

1. Deskryptor posiadacza (holder descriptor) — mały plik JSON pod adresem https://<your host>/.well-known/isto-intents.json, który mówi, kim Państwo są i jakie serwery Państwo prowadzą (schemat, przykład). Aby zostać wpisanym, zawiera "registry": { "listing": "requested", "terms": "https://istointents.org/registry/terms/" }. Należy wpisać "specVersion": "1.0": wszystko, czego portal tu potrzebuje, jest stabilne od wersji 1.0 i do wersji 2.0 zmienia się wyłącznie w sposób zgodny (wersjonowanie).
2. Jeden serwer MCP na tym samym hoście, Streamable HTTP, implementujący powiązanie MCP z profilem consent-link: cztery narzędzia intent_publish_intent, intent_get_intent, intent_list_matches i intent_withdraw_intent, z nazwami pól z jego dokładnego interfejsu. Asystent nie musi się logować: intent_publish_intent zwraca link do Państwa strony i tylko ta osoba może tam potwierdzić.
3. Dwie zasady, których przestrzeganie wymusza sprawdzenie: narzędzie nigdy nie prosi o dane kontaktowe ani ich nie zwraca (żadnego e-maila, telefonu, imienia i nazwiska ani adresu w żadnym narzędziu), a serwer znajduje się na hoście, który publikuje deskryptor.

To, jak znajdują Państwo dopasowania do życzenia — Państwa wyszukiwanie, Państwa ranking, Państwa powiadomienia — zależy od Państwa. Protokół definiuje tylko to, co asystent wysyła i co otrzymuje z powrotem.

Zaczynają Państwo od zera? Posiadacz referencyjny (reference holder) to wszystko powyższe w jednym pliku Node bez zależności — cztery narzędzia, strona zgody (consent page) z double opt-in i dowód pośrednika przekazującego (forwarder) — wraz z testami. Podłączają Państwo swój system wysyłki e-maili i swoje wyszukiwanie; w obecnej postaci przechodzi sprawdzenie i opisane niżej próbne uruchomienie (trial run). Aby zobaczyć, o które kraje pytają ludzie, proszę zajrzeć do popytu według krajów.

Kroki#

1. Opublikować deskryptor i serwer MCP.
2. Sprawdzić swój host poniżej. Sprawdzenie odczytuje deskryptor i sprawdza serwery dokładnie tak, jak zrobi to rejestr, ale niczego nie wpisuje — można je uruchamiać dowolnie często (raz na minutę na host).
3. Gdy wynik brzmi ready, zgłosić swój host: POST https://istointents.org/registry/v0/submit z { "host": "<your host>" }. Zostają Państwo wpisani od razu i są automatycznie ponownie sprawdzani; zmiany w deskryptorze pojawiają się bez ponownego zgłoszenia.
4. Opcjonalnie — odbieranie życzeń od asystentów AI, które jeszcze Państwa nie znają. Większość ludzi nie łączy swojego asystenta z portalem; łączą go raz z pośrednikiem przekazującym, który przekazuje każde życzenie portalowi obsługującemu kraj danej osoby. Aby odbierać te życzenia, należy dodać do deskryptora "forwarding": { "accept": "requested", "terms": "https://istointents.org/forwarding/terms/" }. Pośrednik przekazujący pod adresem https://istointents.com/mcp wywołuje wtedy Państwa cztery narzędzia dla osób z krajów i kategorii, które Państwo obsługują; osoba nadal potwierdza na Państwa stronie, adresem e-mail, który tam wpisuje, a pośrednik przekazujący nigdy go nie widzi. Jest to bezpłatne i można to wyłączyć w każdej chwili za pomocą "accept": "withdrawn". Najpierw proszę przeczytać rozdział o przekazywaniu (forwarding) i warunki przekazywania. Przed włączeniem proszę zaznaczyć próbne uruchomienie w sprawdzeniu poniżej (lub wysłać "trial": "publish"): rejestr wywoła wtedy raz Państwa cztery narzędzia, tak jak zrobiłby to pośrednik przekazujący, w wywołaniu oznaczonym jako test i natychmiast wycofanym, i odpowie, czy są Państwo gotowi na przekazywanie (jak działa próba).

Wpis nie jest certyfikacją: sprawdzenie obejmuje wyłącznie interfejs (jak to działa). Każdy operator odpowiada za własną usługę. Warunki rejestru.

Prywatność. Kto i kiedy jest administratorem danych oraz co dodać do Państwa polityki prywatności: pakiet RODO dla portali (nie stanowi porady prawnej; w języku angielskim).

Pytania#

Proszę pisać do redaktora protokołu za pośrednictwem istointents.com. Niczego tu nie sprzedajemy i nie muszą Państwo z nami rozmawiać, aby dołączyć.