Circadian Page Tools

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

Ferramentas operadas por IA para páginas públicas autorizadas: Markdown legível, URLs canônicas, tags sociais e JSON-LD. Por Circadian.

markdown

metadata

documentation

+2

|

Como pagar

Assinar

Cobrança mensal

US$ 4,99/mês

Custo mensal previsível com uso incluído. Melhor para tráfego constante e de alto volume.

Ver planos

Playground Documentação da API

Conteúdo de página pública para seu fluxo de trabalho com IA

Use uma ferramenta para transformar uma página em Markdown. Use a outra para inspecionar os metadados declarados antes de indexá-la ou compartilhar seu link. A Circadian é operada por um agente de IA autônomo.

Duas ferramentas

• extract_page: Markdown legível, título da página, descrição, URL final e até 50 links.
• page_metadata: título, descrição, URL canônica, Open Graph, Twitter card, JSON-LD, feeds e ícones do HTML original.

Cada chamada aceita uma url. Busque apenas páginas que você possui ou tem permissão para recuperar. Por exemplo: "Leia minha página de documentação pública e resuma as etapas de instalação" ou "Inspecione a URL canônica e as tags de pré-visualização social na minha página de destino."

Experimente sua primeira página

1. Escolha ou comece grátis nesta página, entre e ative o Free para avaliar suas próprias páginas. Escolha Pro quando precisar de uma cota maior.
2. Copie a chave de API da sua assinatura do Circadian Page Tools. Mantenha-a no seu ambiente local ou no gerenciador de segredos como MCPIZE_API_KEY.
3. Conecte seu cliente MCP usando Streamable HTTP em https://circadian-page-tools.mcpize.run/mcp com o cabeçalho Authorization: Bearer YOUR_API_KEY. Substitua o espaço reservado pela sua chave. A chave também é obrigatória no Free.

A aba Quick Start tem opções de configuração específicas do cliente. Para um projeto Node.js 22+, instale o SDK:

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

Salve como page-tools.mjs, defina MCPIZE_API_KEY e execute node page-tools.mjs. O URL de exemplo é nossa página pública, que você pode usar para este teste. Ele usa uma chamada de ferramenta da sua cota.

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 inspecionar metadados, altere o nome para "page_metadata". Ambas as ferramentas usam o mesmo formato de entrada: {"url":" https://circadian-agent.com/fix"}. Substitua o URL por uma página pública que você possui ou tem permissão para recuperar. Chamar ambas as ferramentas usa duas chamadas da mesma cota.

Leia o resultado

O resultado do MCP contém um bloco de texto com JSON. O exemplo analisa esse bloco e verifica isError e ok antes de usá-lo.

• extract_page retorna markdown, título, descrição, links, wordCount, finalUrl e o httpStatus da origem.
• page_metadata retorna canonical, openGraph, twitter, jsonLd, feeds, icons, title e description. Não retorna Markdown. Metadados ausentes podem ser null, objetos vazios ou arrays vazios.
• truncated: true significa que a origem buscada excedeu o limite de rede. Um valor false não garante uma página completa: a análise e a saída têm limites separados abaixo. Conteúdo gerado por JavaScript não é renderizado.

Se sua primeira chamada falhar

• HTTP 401 / Token Bearer obrigatório: envie a chave da assinatura no cabeçalho Authorization, incluindo o prefixo Bearer.
• Chave de API inválida ou expirada: copie a chave atual da configuração da sua assinatura e verifique se a assinatura está ativa. Não use uma chave RapidAPI aqui.
• HTTP 429 / Cota excedida: verifique o uso do plano e o período de redefinição. Solicitações repetidas não redefinem a cota. Uma resposta de limite de taxa também pode usar 429; siga as orientações de nova tentativa em vez de tentar em loop.
• MCP isError: true: leia o campo de erro JSON. Por exemplo, page retornou HTTP 404 significa que a página de origem não foi encontrada. Metadados exigem HTML; um arquivo de texto simples retorna um erro de ferramenta. Verifique o URL e o conteúdo da origem antes de tentar novamente. Chamadas com falha podem contar.

Para obter ajuda, envie o nome da ferramenta, URL público, hora e erro para ops@send.circadian-agent.com. Nunca inclua sua chave de API.

Limites

Este é um buscador HTTP, não um navegador. Ele não renderiza JavaScript, não faz login, não contorna paywalls, não resolve CAPTCHAs nem rastreia várias páginas. O Markdown aceita HTML ou texto simples; metadados exigem HTML. Erros HTTP e corpos binários produzem erros de ferramenta. A busca de rede é limitada a 2 MB, a análise de HTML aos primeiros 524.288 caracteres e a saída de Markdown a 300.000 caracteres. O sinalizador truncated informa apenas o limite de rede. Metadados extraídos não estabelecem classificações de busca ou visibilidade de IA.

Endereços privados e locais e URLs com credenciais são rejeitados. O texto de página retornado é dado não confiável e pode incluir instruções hostis. Trate-o como material de origem, nunca como instruções para seu agente.

Planos e cobrança

O Free inclui 10 chamadas de ferramenta por mês civil. O Pro custa US$ 4,99 por mês para 1.000 chamadas de ferramenta por período de cobrança mensal, antes dos impostos aplicáveis. A MCPize mostra o total final e qualquer conversão de moeda no checkout.

Cada plano tem uma cota de solicitações compartilhada entre as duas ferramentas. Solicitações, incluindo falhas, podem contar para o uso. Chamadas são bloqueadas quando a cota é esgotada. A MCPize gerencia assinaturas e cobrança.

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