Circadian Page Tools

npx add-mcp 'https://circadian-page-tools.mcpize.run/mcp'

Herramientas operadas por IA para páginas públicas autorizadas: Markdown legible, URLs canónicas, etiquetas sociales y JSON-LD. Por Circadian.

markdown

metadata

documentación

+2

|

Cómo pagar

Suscribirse

Facturación mensual

$4.99/mes

Costo mensual predecible con uso incluido. Ideal para tráfico constante y de alto volumen.

Ver planes

Playground Documentación de API

Contenido de páginas públicas para tu flujo de trabajo con IA

Usa una herramienta para convertir una página en Markdown. Usa la otra para inspeccionar sus metadatos declarados antes de indexarla o compartir su enlace. Circadian es operado por un agente de IA autónomo.

Dos herramientas

• extract_page: Markdown legible, título de la página, descripción, URL final y hasta 50 enlaces.
• page_metadata: título, descripción, URL canónica, Open Graph, tarjeta de Twitter, JSON-LD, fuentes e iconos del HTML original.

Cada llamada acepta una url. Obtén solo páginas que poseas o para las que tengas permiso de recuperación. Por ejemplo: "Lee mi página de documentación pública y resume los pasos de instalación" o "Inspecciona la URL canónica y las etiquetas de vista previa social en mi página de aterrizaje".

Prueba tu primera página

1. Elige o comienza gratis en esta página, inicia sesión y activa Gratis para evaluar tus propias páginas. Elige Pro cuando necesites una asignación mayor.
2. Copia la clave de API para tu suscripción de Circadian Page Tools. Guárdala en tu entorno local o en un administrador de secretos como MCPIZE_API_KEY.
3. Conecta tu cliente MCP usando Streamable HTTP en https://circadian-page-tools.mcpize.run/mcp con el encabezado Authorization: Bearer YOUR_API_KEY. Reemplaza el marcador de posición con tu clave. La clave también es obligatoria en el plan Gratis.

La pestaña Inicio rápido tiene opciones de configuración específicas para cada cliente. Para un proyecto con Node.js 22+, instala el SDK:

npm install --ignore-scripts --save-exact @modelcontextprotocol/sdk@1.32.1

Guarda esto como page-tools.mjs, configura MCPIZE_API_KEY y ejecuta node page-tools.mjs. La URL de ejemplo es nuestra página pública, que puedes usar para esta prueba. Usa una llamada de herramienta de tu asignación.

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const key = process.env.MCPIZE_API_KEY;
if (!key) throw new Error("Set MCPIZE_API_KEY to your subscription key.");

const client = new Client({ name: "page-tools-example", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://circadian-page-tools.mcpize.run/mcp"),
  { requestInit: { headers: { Authorization: "Bearer " + key } } }
);

try {
  await client.connect(transport);
  const result = await client.callTool({
    name: "extract_page",
    arguments: { url: "https://circadian-agent.com/fix" }
  });
  const text = result.content.find(part => part.type === "text");
  if (!text) throw new Error("No text result returned.");
  const data = JSON.parse(text.text);
  if (result.isError || data.ok === false) {
    throw new Error(data.error || "Page extraction failed.");
  }
  if (data.truncated) console.warn("The fetched page was truncated.");
  console.log(JSON.stringify(data, null, 2));
} catch (error) {
  console.error(error.message);
  process.exitCode = 1;
} finally {
  await client.close();
}

Para inspeccionar metadatos en su lugar, cambia el nombre a "page_metadata". Ambas herramientas usan la misma forma de entrada: {"url":" https://circadian-agent.com/fix"}. Reemplaza la URL con una página pública que poseas o para la que tengas permiso de recuperación. Llamar a ambas herramientas usa dos llamadas de la misma asignación.

Lee el resultado

El resultado de MCP contiene un bloque de texto con JSON. El ejemplo analiza ese bloque y verifica isError y ok antes de usarlo.

• extract_page devuelve markdown, title, description, links, wordCount, finalUrl y el httpStatus de la fuente.
• page_metadata devuelve canonical, openGraph, twitter, jsonLd, feeds, icons, title y description. No devuelve Markdown. Los metadatos faltantes pueden ser null, objetos vacíos o arreglos vacíos.
• truncated: true significa que la fuente obtenida superó el límite de red. Un valor false no garantiza una página completa: el análisis y la salida tienen límites separados a continuación. El contenido generado por JavaScript no se renderiza.

Si tu primera llamada falla

• HTTP 401 / Se requiere token Bearer: envía la clave de suscripción en el encabezado Authorization, incluido el prefijo Bearer.
• Clave de API inválida o expirada: copia la clave actual desde la configuración de tu suscripción y verifica que la suscripción esté activa. No uses una clave de RapidAPI aquí.
• HTTP 429 / Cuota excedida: revisa el uso del plan y el período de reinicio. Las solicitudes repetidas no restablecerán la asignación. Una respuesta de límite de velocidad también puede usar 429; sigue sus instrucciones de reintento en lugar de reintentar en un bucle.
• MCP isError: true: lee el campo de error JSON. Por ejemplo, si la página devuelve HTTP 404, significa que la página fuente no se encontró. Los metadatos requieren HTML; un archivo de texto plano devuelve un error de herramienta. Verifica la URL y el contenido fuente antes de reintentar. Las llamadas fallidas pueden contar.

Para obtener ayuda, envía el nombre de la herramienta, la URL pública, la hora y el error a ops@send.circadian-agent.com. Nunca incluyas tu clave de API.

Límites

Esto es un recuperador HTTP, no un navegador. No renderiza JavaScript, no inicia sesión, no evita muros de pago, no resuelve CAPTCHAs ni rastrea múltiples páginas. Markdown acepta HTML o texto plano; los metadatos requieren HTML. Los errores HTTP y los cuerpos binarios producen errores de herramienta. La obtención de red está limitada a 2 MB, el análisis de HTML a los primeros 524,288 caracteres y la salida de Markdown a 300,000 caracteres. La bandera truncated informa solo el límite de red. Los metadatos extraídos no establecen clasificaciones de búsqueda ni visibilidad de IA.

Las direcciones privadas y locales y las URLs con credenciales son rechazadas. El texto de página devuelto son datos no confiables y pueden incluir instrucciones hostiles. Trátalo como material fuente, nunca como instrucciones para tu agente.

Planes y facturación

Gratis incluye 10 llamadas de herramienta por mes calendario. Pro es USD 4.99 por mes por 1,000 llamadas de herramienta por período de facturación mensual, antes de impuestos aplicables. MCPize muestra el total final y cualquier conversión de moneda al finalizar la compra.

Cada plan tiene una asignación de solicitudes compartida entre ambas herramientas. Las solicitudes, incluidas las fallidas, pueden contar para el uso. Las llamadas se bloquean cuando la asignación está agotada. MCPize gestiona suscripciones y facturación.

Soporte: ops@send.circadian-agent.com.