Guia: Claro a les teves eines
Claro al teu assistent i als teus sistemes
Claro de Casafari té tres portes d'accés: l'aplicació, el teu assistent d'IA i els teus propis sistemes. Rere cadascuna hi ha el mateix Claro; per tant, un brief retorna els mateixos locals, els mateixos recomptes exactes i els mateixos verdictes amb les seves evidències, sigui quina sigui la porta que utilitzis. El compte de la plataforma Casafari de la teva empresa obre tant el teu assistent com els teus sistemes.
Des del teu assistent
Afegeix Claro a l'assistent que el teu equip ja utilitza i demana locals com ho faries quan dones un brief a un agent immobiliari, en qualsevol idioma. Funciona amb qualsevol assistent capaç de connectar-se a un servidor MCP remot: Claude (aplicació d'escriptori i claude.ai), Claude Code, ChatGPT (de moment en mode desenvolupador), Cursor, VS Code, Copilot Studio, Perplexity i altres clients MCP.
Un exemple. Un responsable d'expansió que té incloses dades d'ubicació al seu compte escriu: 'Cerca locals en xamfrà en lloguer a Madrid, a peu de carrer, de 150 a 300 m², sense cap gimnàs a menys de 300 m.' L'assistent passa el brief per Claro i respon amb el nombre exacte de locals que encaixen, i quants d'ells indiquen cada criteri.
Per a cada local indica si està en xamfrà i a peu de carrer, citant les paraules del mateix anunci de l'immoble, com ara “local en esquina a pie de calle” (un exemple), o 'no indicat' quan l'anunci no ho especifica. Si es troba un gimnàs a menys de 300 m, indica quin és i a quina distància es troba, així com l'índex de trànsit de vianants i la població resident propera amb la seva unitat, font i data. A continuació, el responsable d'expansió li demana comparar els tres millors colze a colze i obrir un dossier del primer.
Sigui quin sigui l'assistent, Claro mai no dedueix cap dada que l'anunci no indiqui, mai no esmenta cap propietari particular, mai no mostra el nom d'un portal immobiliari i mai no amaga una xifra rere una etiqueta: un índex de trànsit de vianants s'acompanya del seu número, la seva unitat i la seva font.
- Recomptes exactes: quants locals encaixen i quants indiquen cada criteri
- Un verdicte per criteri (complert, no complert o no indicat), amb les paraules del mateix anunci de l'immoble com a evidència
- Xifres d'ubicació amb la seva unitat, font i data, quan el teu compte inclou dades d'ubicació
- Un verdicte d'encaix amb el seu motiu, un dossier per local i fins a cinc locals comparats colze a colze
- Els preus que es demanen (lloguer o venda) per un tipus de local en una zona, i un brief llegit directament del fitxer que adjuntis
Des dels teus sistemes
La teva eina de selecció d'ubicacions, el teu CRM, BI o equip de dades poden fer crides al mateix Claro de manera programada o des d'un formulari. Els teus desenvolupadors ho configuren una sola vegada i cada resposta inclou les mateixes evidències que l'aplicació.
- Executa el teu brief d'expansió cada nit perquè els locals que s'incorporin al mercat arribin al teu pipeline l'endemà al matí.
- Pagina tots els locals que encaixin, fins a 200 locals per pàgina, en lloc de veure només la primera pantalla de resultats.
- Avalua cada local amb el teu propi model, fent servir cada xifra amb la seva unitat i font, i cada fet amb la seva frase citada.
- Explica qualsevol punt d'Espanya amb el trànsit de vianants, la població resident, la capacitat de despesa i els punts d'interès propers, per als locals que els teus agents immobiliaris hagin trobat en un altre lloc.
- Ofereix una cerca simple per paraules clau en un formulari senzill, sense lectura d'IA del brief.
- Mantingues la teva llista d'establiments i de la competència al teu compte, de manera que un brief pugui incloure 'cap establiment propi a menys de 500 m'.
Les teves dades
Els teus briefs d'expansió, la teva llista d'establiments i les de la competència es queden al teu compte; cap altre client de Claro no els veurà mai. Si un brief diu 'cap establiment propi a menys de 500 m', es comprova únicament respecte a la teva llista, tal com s'explica a evitar la canibalització.
Les dades d'ubicació són una opció de pagament per a cada compte. Sense aquestes dades, la cerca s'executa igualment sobre tot el que diuen els anuncis dels immobles, i els criteris d'ubicació (com un llindar de trànsit de vianants o 'cap gimnàs a menys de 300 m') no s'apliquen: la resposta ho especifica i n'explica el motiu, de manera que res no s'omet d'amagat.
Els recomptes són exactes, no estimacions, i cada dada està citada de l'anunci de l'immoble d'on prové. Tot el que un anunci no esmenti és 'no indicat', mai 'no'. Com calcula Claro els locals i comprova cada dada s'explica a la metodologia.
Com obtenir una clau
Claro es connecta com qualsevol altra API i MCP de Casafari: mitjançant el compte de la teva empresa a platform.casafari.com, amb una clau de la plataforma o iniciant sessió amb aquest compte, segons les condicions de la plataforma. Des del compte es creen i es revoquen les claus. El mateix accés funciona al teu assistent i als teus sistemes, i cada compte té els seus propis límits, establerts per l'equip de Casafari.
És la teva primera vegada a Casafari? Crea un compte gratuït a platform.casafari.com des de Comença gratis a la pàgina d'inici o a la mateixa plataforma. El compte de la teva empresa allà inclou el teu pla i les teves claus; el pla gratuït inclou una primera cerca per provar Claro. Per a un pla personalitzat, parla amb l'equip de Casafari mitjançant el formulari de la pàgina d'inici.
- Encara no tens compte de Casafari: crea'n un de gratuït a platform.casafari.com.
- L'equip de Casafari configura el teu compte a platform.casafari.com, amb els teus mercats, les teves dades d'ubicació i els teus límits.
- Connecta el teu assistent iniciant sessió amb el compte de la plataforma, o bé crea-hi una clau de la plataforma perquè el teu desenvolupador connecti els teus sistemes.
Per als teus desenvolupadors
A la referència per a desenvolupadors trobaràs totes les operacions, límits i errors. La configuració següent connecta qualsevol assistent amb Claro a la plataforma; si s'inicia sessió amb OAuth, no cal cap clau. Tres elements a transmetre:
- Claro funciona com a servidor MCP i com a API REST, amb el mateix accés de la plataforma i les mateixes respostes que l'aplicació.
- L'accés pertany al compte de la plataforma de la teva empresa: una clau de la plataforma o l'inici de sessió de la plataforma (OAuth), creats i revocats en aquest compte segons les condicions de la plataforma, i mai s'han d'incloure en fitxers compartits.
- Els límits i les dades d'ubicació del teu compte s'apliquen a cada crida, des de qualsevol porta d'accés.
Passa això al teu desenvolupador o enganxa-ho al teu assistent
# Claude Code
claude mcp add --transport http claro https://platform.casafari.com/mcp/claro --header "Authorization: Bearer $CASAFARI_API_KEY"
# Altres clients MCP
{
"mcpServers": {
"claro": {
"url": "https://platform.casafari.com/mcp/claro",
"headers": {
"Authorization": "Bearer ${CASAFARI_API_KEY}"
}
}
}
}
Els clients que inicien sessió amb l'OAuth de la plataforma es connecten sense clau: omet la capçalera.
Preguntes freqüents
Quins assistents poden utilitzar Claro?
Qualsevol assistent que es pugui connectar a un servidor MCP remot: Claude (aplicació d'escriptori i claude.ai), Claude Code, ChatGPT (de moment en mode desenvolupador), Cursor, VS Code, Copilot Studio i Perplexity. El teu desenvolupador o equip d'IT afegeix Claro una vegada, amb la clau o l'inici de sessió del compte de la plataforma; a partir d'aquell moment, qualsevol persona que utilitzi aquest assistent pot enviar un brief a Claro amb paraules senzilles i en qualsevol idioma.
El meu assistent veu els mateixos locals que l'aplicació?
Sí. L'aplicació, el teu assistent i els teus sistemes funcionen tots amb el mateix Claro, de manera que un mateix brief retorna els mateixos locals, el mateix recompte exacte i els mateixos verdictes amb les seves evidències. El que pot veure el teu compte també és el mateix: les seves dades d'ubicació, si estan incloses, i les llistes d'establiments propis i de la competència.
El meu equip pot mantenir la seva pròpia avaluació?
Sí. Claro comprova els criteris que has indicat; no imposa una puntuació pròpia. Els teus sistemes poden paginar tots els resultats i passar cada local al teu propi model, on cada xifra inclou la seva unitat, font i data, i cada fet la seva frase citada. El teu model decideix el rànquing a partir d'evidències verificables.
Què passa amb un criteri d'ubicació si no tenim dades d'ubicació?
La cerca s'executa igualment sobre tot el que diuen els anuncis dels immobles. Un criteri d'ubicació, com ara un llindar de trànsit de vianants o 'cap gimnàs a menys de 300 m', no s'aplica, i la resposta ho especifica i n'explica el motiu per no ometre res d'amagat. Les dades d'ubicació són un servei addicional de pagament; demana a l'equip de Casafari que les inclogui al teu compte.
Podem incloure la cerca de Claro a la nostra intranet?
Sí. El quadre d'integració és un cercador de Claro per a la teva intranet o web. Utilitza una clau publicable que només funciona des de les teves adreces web, així que no es pot reutilitzar en cap altre lloc. El teu equip escriu un brief i veu els locals que encaixen amb els seus verdictes i evidències, dins dels límits del teu compte.
Qui emet la clau i qui la pot revocar?
El compte de la teva empresa a platform.casafari.com genera i revoca les claus de la plataforma de Claro, com per a qualsevol altra API i MCP de Casafari, segons les condicions de la plataforma; un assistent també pot iniciar sessió amb aquest compte. Revoca una clau des d'allà quan algú marxi o si queda exposada. Si la teva empresa no té compte de Casafari, primer en pot crear un de gratuït a platform.casafari.com.
Porta Claro al teu assistent i als teus sistemes
Crea un compte gratuït a platform.casafari.com des de Comença gratis a la pàgina d'inici. Al compte de la teva empresa podràs crear les teves claus, comprar crèdits o triar un pla. Abans d'això, la cerca gratuïta de la pàgina d'inici et mostra què dona Claro per al teu propi brief d'expansió, sense cap registre.
Comença gratis