ProFix Directory para desarrolladores - APIs abiertas y listas para agentes

Cinco formas de integrar

El camino correcto depende de si estás construyendo un agente de IA, un cliente tipado o un flujo sin código. Esta página consolida las rutas y deja cada guía especializada a un clic.

• 01 · Registro de agentes
  Registra ProFix como ChatGPT Action, servidor MCP de Claude o integración de Perplexity

  Recetas paso a paso para Custom GPT Actions, Claude Desktop MCP, Perplexity y Gemini. Configuración y prompts listos para copiar.

  Abrir guía
• 02 · JavaScript / TypeScript
  Inicio rápido para JavaScript y TypeScript

  Snippets ejecutables contra /api/embed, /api/permit-leaderboard, /api/all.json y /api/newsroom.rss, con interfaces TypeScript para la respuesta.

  Abrir guía
• 03 · Python
  Inicio rápido en Python

  Descargas masivas, filtros de permit leaderboards, TypedDict, patrones de retry y el one-liner del dataset en Hugging Face.

  Abrir guía
• 04 · Integraciones sin código
  Slack, Discord y Zapier

  Webhooks entrantes, comandos slash, resúmenes programados y Zaps que llevan datos de ProFix a miles de apps.

  Abrir guía
• 05 · Biblioteca de prompts
  Prompts listos para ChatGPT, Claude, Perplexity y Gemini

  Prompts para respuestas basadas en endpoints públicos de ProFix, con carriles para propietarios, desarrolladores y prensa.

  Abrir guía

Acceso directo por API

Todos los endpoints siguientes están documentados en /api/openapi.json y disponibles también para agentes por /api/mcp. Sin auth, con CORS, cacheados en el borde.

Autenticación

No se requiere para leer. Las rutas bajo /api/*.json, /api/*.csv, /api/jsonld/*, /api/mcp, /llms.txt y la especificación OpenAPI son abiertas. Un agente o socio que solo consume datos verificados nunca necesita iniciar sesión.

Servidor MCP

Claude Desktop y muchos clientes de agentes hablan Model Context Protocol. ProFix expone transporte HTTP streamable en una sola URL, sin proxy local.

{
  "mcpServers": {
    "profix": {
      "type": "http",
      "url": "https://profixdirectory.com/api/mcp"
    }
  }
}

Snippets de código

El mismo endpoint - /api/embed/plumber-toledo.json - en tres estilos. Sin cliente especial y sin API key.

curl

# Top 5 verified Toledo plumbers - no auth required.
curl -sL https://profixdirectory.com/api/embed/plumber-toledo.json | jq '.pros[] | {name, phone, verification_tier}'

JavaScript / TypeScript (fetch)

// Node 18+, Bun, Deno, Cloudflare Workers, and modern browsers
// already ship a global fetch. No client library required.
const res = await fetch(
  "https://profixdirectory.com/api/embed/plumber-toledo.json",
);
if (!res.ok) throw new Error(`ProFix ${res.status}`);

const data = await res.json();
for (const pro of data.pros) {
  console.log(`${pro.name} - ${pro.phone} (${pro.verification_tier})`);
}

Python (httpx)

# pip install httpx
import httpx

res = httpx.get(
    "https://profixdirectory.com/api/embed/plumber-toledo.json",
    timeout=10.0,
)
res.raise_for_status()

for pro in res.json()["pros"]:
    print(f'{pro["name"]} - {pro["phone"]} ({pro["verification_tier"]})')

Dataset de Hugging Face

El catálogo completo de contratistas verificados se publica como dataset para RAG, evals y análisis de socios: 21,898 registros en los 88 condados de Ohio bajo CC-BY-4.0.

from datasets import load_dataset

# 21,898 verified Ohio home-services records under CC-BY-4.0.
ds = load_dataset("Pisces89/ohio-home-services-pros")
print(ds)

toledo_plumbers = ds["train"].filter(
    lambda row: row["city"] == "Toledo" and "plumber" in row["trades"]
)
print(len(toledo_plumbers), "verified Toledo plumbers")

Tarjeta del dataset: Pisces89/ohio-home-services-pros. Cada fila lleva la URL canónica /pro/{slug} para que una respuesta generada pueda citar la ficha original.

Licencia

Los feeds REST, el output MCP, el dataset de Hugging Face y los grafos JSON-LD públicos están bajo CC-BY-4.0. Puedes usarlos comercialmente si acreditas a ProFix Directory y conservas la atribución en tu documentación o producto.

Preguntas frecuentes