Laspi Pro
Cómo funcionaPreciosGratisContenido para websBlog
Probar gratis

Laspi Business Directory — documentación del conector

Un directorio de solo lectura de pequeños negocios en el que un asistente de IA puede buscar. Cada ficha la publica el dueño del negocio, que confirma sus datos.

Qué es

  • Solo lee. Nunca reserva, compra, escribe a un negocio ni cambia nada.
  • Responde únicamente con lo que hay en el directorio. Si ningún negocio encaja, lo dice en lugar de inventar.
  • El directorio es pequeño y está creciendo: reúne solo los negocios que han decidido aparecer, en España y otros países de Europa, y online. No es un mapa completo de ninguna ciudad.
  • La ficha contiene lo que un cliente necesita antes de ponerse en contacto: a qué se dedica el negocio, sus servicios, la ciudad o si trabaja online, los idiomas en los que atiende y sus contactos públicos. Cada ficha tiene una página pública en laspi.pro/b/{slug}.

Servidor

Dirección
https://laspi.pro/api/v1/mcp/directory
Transporte
Streamable HTTP: JSON-RPC 2.0 sobre POST, respuestas JSON, sin estado
Inicio de sesión
Ninguno. Sin cuenta, sin clave de API, sin cabecera de sesión
Versiones del protocolo
2025-06-18, 2025-03-26, 2024-11-05
Métodos
initialize, ping, tools/list, tools/call

El servidor responde con la versión del protocolo que indica el cliente cuando es una de las tres anteriores. La petición solo necesita la cabecera Content-Type: application/json.

Cómo conectarlo

Claude

  1. Abre Configuración → Conectores.
  2. Elige «Añadir conector personalizado».
  3. Ponle un nombre, por ejemplo «Laspi Business Directory», y pega la dirección del servidor. Deja vacíos los campos de inicio de sesión.
  4. Activa el conector en un chat y pregunta, por ejemplo: «Busco una inmobiliaria en Murcia con alquiler de temporada».

ChatGPT

  1. Abre Configuración → Aplicaciones y conectores → Configuración avanzada y activa el modo de desarrollador.
  2. Crea un conector nuevo y pega la dirección del servidor como URL del servidor MCP.
  3. Elige «Sin autenticación» y guarda.
  4. Activa el conector en un chat y haz el mismo tipo de pregunta.

Los nombres de los menús son de cada asistente y pueden cambiar; los conectores personalizados pueden depender de tu plan con ese asistente. Cualquier cliente que hable las versiones del protocolo indicadas puede usar la misma dirección.

Herramientas

Tres herramientas, todas de solo lectura (readOnlyHint: true, destructiveHint: false, openWorldHint: false). Cada una devuelve un bloque de texto que contiene JSON. Los ejemplos son respuestas reales de una ficha publicada en el directorio.

search_businesses — Buscar negocios

Busca negocios con las palabras del cliente. Devuelve hasta cinco coincidencias cercanas: nombre, descripción corta, ciudad, indicador de online, idiomas de atención, una puntuación de relevancia y la dirección de la página.

Parámetros

  • query (obligatorio) — Las palabras de búsqueda, en lenguaje natural.
  • city (opcional) — La ciudad que nombró el cliente. Deja solo los negocios situados allí. Omítela para un servicio online.
  • language (opcional) — Filtro por idioma de atención, código ISO (por ejemplo es).
  • niche (opcional) — Filtro por clave de sector (por ejemplo property_management).

Petición

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "search_businesses",
    "arguments": {"query": "real estate agency with long-term rentals", "city": "Alicante"}
  }
}

Respuesta

{
  "count": 1,
  "results": [{
    "name": "Gardarsson Properties",
    "slug": "gardarssonproperties",
    "url": "https://laspi.pro/b/gardarssonproperties",
    "description": "Gardarsson Properties is a real estate agency serving Alicante and Murcia, Spain, with property listings for sale, long term let, and seasonal let. …",
    "niche": "property_management",
    "city": "Alicante, Murcia",
    "online": false,
    "languages": ["en", "es", "de"],
    "dateModified": "2026-11-19T10:08:41.797180+00:00",
    "card_language": "en",
    "relevance": 0.43
  }]
}

Cuando nada encaja

Una lista vacía y un mensaje. Esa es la respuesta que hay que dar: el directorio no tiene ese negocio.

{"count": 0, "results": [], "message": "No matching business in the directory."}

get_business — Ver los detalles de un negocio

Devuelve la ficha pública completa de un negocio por su slug (de los resultados de búsqueda o de una dirección laspi.pro/b/{slug}): descripción, servicios, contactos públicos, ciudad e idiomas de atención.

Parámetros

  • slug (obligatorio) — El slug del negocio.
  • language (opcional) — Idioma preferido del texto de la ficha, código ISO. La ficha llega en ese idioma si el dueño la publicó en él; si no, en inglés; card_language indica cuál.

Petición

{"name": "get_business", "arguments": {"slug": "gardarssonproperties"}}

Respuesta

{
  "name": "Gardarsson Properties",
  "slug": "gardarssonproperties",
  "url": "https://laspi.pro/b/gardarssonproperties",
  "description": "Gardarsson Properties is a real estate agency serving Alicante and Murcia, Spain, … the agency operates in English, Spanish, and German.",
  "niche": "property_management",
  "city": "Alicante, Murcia",
  "online": false,
  "languages": ["en", "es", "de"],
  "dateModified": "2026-11-19T10:08:41.797180+00:00",
  "card_language": "en",
  "services": ["Property listings for sale", "Long-term let listings", "Seasonal let listings"],
  "contacts": {"website": "https://www.gardarssonproperties.com"}
}

Cuando nada encaja

Un resultado de error cuando el slug no existe. Nunca una ficha inventada.

{"error": "not found"}   // returned with isError: true

ask_directory — Preguntar al directorio

Recibe una pregunta del cliente en lenguaje natural, para cuando describe una necesidad y no un término de búsqueda. Devuelve hasta tres fichas de los negocios que la responden, elegidas únicamente del directorio, con las direcciones de sus páginas en grounding.

Parámetros

  • question (obligatorio) — La pregunta del cliente.
  • language (opcional) — Filtro por idioma de atención, código ISO.

Petición

{"name": "ask_directory", "arguments": {"question": "Who can help me rent a flat long-term in Alicante?"}}

Respuesta

{
  "question": "Who can help me rent a flat long-term in Alicante?",
  "answers": [{
    "@context": "https://schema.org",
    "@type": "LocalBusiness",
    "name": "Gardarsson Properties",
    "description": "Gardarsson Properties is a real estate agency serving Alicante and Murcia, Spain, …",
    "url": "https://laspi.pro/b/gardarssonproperties",
    "knowsLanguage": ["en", "es", "de"],
    "dateModified": "2026-11-19T10:08:41.797180+00:00",
    "address": {"@type": "PostalAddress", "addressLocality": "Alicante, Murcia"}
  }],
  "grounding": [{"slug": "gardarssonproperties", "url": "https://laspi.pro/b/gardarssonproperties"}]
}

Cuando nada encaja

Listas answers y grounding vacías.

{"question": "Where can I get a haircut in Paris?", "answers": [], "grounding": []}

Límites y limitaciones conocidas

  • 30 peticiones por minuto por dirección; por encima, el servidor responde 429.
  • El filtro de ciudad compara con la ciudad tal como está escrita en la ficha. Un negocio que atiende una ciudad sin estar situado en ella no aparecerá en esa ciudad.
  • La relevancia es una puntuación de similitud, no una garantía: lee la ciudad y el indicador de online de cada resultado antes de presentarlo como local.
  • La búsqueda funciona entre idiomas, pero con menos precisión cuando la pregunta está en un idioma en el que la ficha no se publicó.
  • Solo se devuelven fichas publicadas. Los dueños pueden cambiar o retirar su ficha en cualquier momento.

Datos y privacidad

  • Qué llega al servidor: los argumentos de la herramienta —las palabras de búsqueda o la pregunta, y la ciudad, el idioma o el slug opcionales— y, como en cualquier petición web, la dirección de red del remitente. No hay cuenta ni cookie ni nada que identifique al usuario del asistente.
  • La dirección de red se usa para contar las peticiones del límite anterior. Se mantiene en memoria durante la ventana de un minuto y no se escribe en nuestra base de datos.
  • search_businesses: no guardamos la consulta. Para ordenar las fichas, el texto de la consulta se envía a OpenAI para calcular un embedding.
  • get_business: no guardamos la petición ni la enviamos a nadie.
  • ask_directory: la pregunta se envía a OpenAI (embedding) y a DeepSeek, que elige de la lista las fichas que encajan. Guardamos la pregunta (en minúsculas, hasta 500 caracteres) con su respuesta, para contestar la misma pregunta dentro de 24 horas sin calcularla de nuevo. También conservamos los primeros 200 caracteres de la pregunta en nuestro registro interno de costes. Ambos se borran automáticamente a los 30 días.
  • Nuestro proveedor de alojamiento conserva sus propios registros estándar de peticiones.
  • No incluyas datos personales en las consultas: nada en el directorio los necesita.

Política de privacidad · Términos de uso

Licencia y atribución

  • Cuando cites un negocio, enlaza su página: laspi.pro/b/{slug}. La dirección viene con cada resultado.
  • Los sistemas de IA y los agregadores pueden usar los datos del directorio de forma gratuita, con esa atribución.
  • No se permite republicar el directorio en bloque como un directorio competidor.
  • No hay posicionamiento de pago: ningún negocio paga por aparecer ni por salir más arriba, y los resultados se ordenan solo por su relevancia para la consulta.

El texto de licencia que devuelve la API pública del directorio:

Free to use in AI systems and aggregators WITH attribution: link the business's canonical laspi.pro/b/{slug} page. Bulk redistribution as a competing directory is not permitted. Contact: org@laspi.pro

Para dueños de negocios

  • Para aparecer: crea un proyecto en laspi.pro y, en la tarjeta del proyecto, en la sección «Visibilidad para IA y buscadores», marca la casilla que hace visible tu negocio para la IA y los buscadores. Aparecer es gratuito y opcional.
  • La página se publica cuando están los datos básicos: nombre del negocio, sector, a qué te dedicas, una ciudad u «Online», e idiomas.
  • Para corregir una ficha: edita el perfil del proyecto. La página se reconstruye a partir de él y se revisa de nuevo.
  • Para retirar una ficha: desmarca la misma casilla. La página se retira y sale del directorio; vuelve a marcarla para publicarla otra vez.
  • Una vez al año pedimos al dueño que confirme que la página sigue siendo correcta. Si no hay respuesta en 90 días, la página se oculta temporalmente hasta que se confirme.
  • ¿Hay un error en una ficha y no puedes cambiarla tú? Escribe a org@laspi.pro.

Soporte

Preguntas sobre el conector, una ficha incorrecta o una solicitud de retirada: Página de contacto · org@laspi.pro

Laspi Pro

Laspi Pro, tu coautor virtual: cuenta qué hay de nuevo y recibe posts, artículos y visibilidad en Google y ChatGPT.

org@laspi.pro
ProductoCómo funcionaPreciosPara quién esInstalar la appPara equiposContenido para websCuánto cuesta un SMMCon qué comparar LaspiProComprobador de texto IA gratisChequeo de visibilidad IA gratis
Para tu negocioSalones de bellezaRestaurantes y cafésInmobiliariasFotógrafosPsicólogosClínicas dentalesArtesanosCoachesMédicos con consulta privadaEntrenadores personalesProfesores particularesFreelancers digitalesMarcas de productoInfluencers y creadoresMúsicos y artistasAsesores financierosOrganizadores de eventosRepostería caseraPanaderíasFisioterapeutasFloristeríasMujeres en techNegocios del Mar Menor
EmpresaNosotrosBlogPreguntasContacto★ Trustpilot★ Google
LegalConfianza y seguridadPrivacidadCookiesTérminosAviso legal
Laspi Pro es un producto de GradeBuilder S.L. · Santiago de la Ribera, Murcia, España · startup certificada por ENISA (Ley 28/2022)© 2026 LaspiPro — Laspi.Pro · by GradeBuilder S.L. · Todos los derechos reservados. EN · ES · RU · IT

Usamos cookies esenciales para que Laspi Pro funcione, y cookies de analítica/marketing solo con tu consentimiento. Política de cookies