Datacircle: Perfis do LinkedIn, Sem Taxa Adicional

Visão Geral

Datacircle é uma cooperativa de dados. Consulte suas APIs de dados B2B favoritas através de nós. Mesma solicitação, mesmo preço, sem taxa adicional.

Você envia a solicitação do próprio provedor para api.datacircle.dev, com sua chave Datacircle. Essa é a única alteração. Atualmente, temos 3 APIs de perfis do LinkedIn ativas em que confiamos: Up2Data, HarvestAPI e Fetchin. Cada solicitação vai para o provedor e obtém o perfil como ele está hoje.

Esta habilidade abrange as duas formas de acesso, o servidor MCP hospedado e a API REST: qual provedor escolher, perguntando antes de cada consulta paga, lendo o custo e o saldo em cada resposta, e os erros.

Quando Usar

• Use quando o usuário fornecer um ou mais URLs de perfil do LinkedIn e quiser o cargo atual da pessoa, empresa, histórico de trabalho, educação ou habilidades.
• Use quando o usuário perguntar sobre o saldo do Datacircle, ou por que uma chamada Datacircle respondeu 402 ou 429.
• Não use para encontrar pessoas por nome, cargo ou empresa: Datacircle consulta um perfil apenas pelo URL do LinkedIn.
• Não use para prospecção. Esta habilidade lê perfis; ela nunca envia uma mensagem ou um pedido de conexão.

Acesso e Autenticação

Servidor MCP (preferido quando o cliente o suporta)

• Endpoint: https://api.datacircle.dev/mcp (HTTP Streamable), no registro oficial do MCP como dev.datacircle/datacircle.
• Código Claude: claude mcp add --transport http datacircle https://api.datacircle.dev/mcp, depois execute /mcp para fazer login. No Claude (Configurações, Conectores) e ChatGPT (modo desenvolvedor), adicione o mesmo URL como um conector personalizado. Na primeira vez, seu cliente o conecta com seu e-mail Datacircle (OAuth). Ou envie sua chave de API como um token Bearer:

claude mcp add --transport http datacircle https://api.datacircle.dev/mcp \
  --header "Authorization: Bearer $DATACIRCLE_API_KEY"

• Se o cliente já o conectou, prefira suas ferramentas em vez de HTTP bruto: get_linkedin_profile (url, e provider: up2data, o padrão, harvestapi ou fetchin) e get_balance (gratuito). Ele também tem list_files, get_download_link e add_funds.

API REST

• URL Base: https://api.datacircle.dev. Especificação OpenAPI: https://docs.datacircle.dev/openapi.json. Docs: https://docs.datacircle.dev.
• Leia a chave de API da variável de ambiente DATACIRCLE_API_KEY e envie-a como Authorization: Bearer $DATACIRCLE_API_KEY. Nunca coloque a chave em um URL e nunca a imprima.
• O cabeçalho X-Data-Provider nomeia o provedor (up2data, harvestapi ou fetchin). A solicitação e a resposta são do próprio provedor, mais um objeto datacircle_meta.

Preços e Limites

• Cadastre-se em datacircle.dev com seu e-mail de trabalho: um crédito de US$ 5, o que equivale a 2.105 perfis do LinkedIn a US$ 2,375 por 1.000.
• US$ 2,375 por 1.000 através do Up2Data (um perfil que ele não consegue encontrar é gratuito), US$ 3,70 por 1.000 através do HarvestAPI.
• US$ 1,485 por 1.000 através do Fetchin, um perfil que ele não consegue encontrar é cobrado o mesmo.
• Up2Data cobra US$ 1 por dia por conta (421 perfis), com um limite diário compartilhado para todos os clientes, depois responde 429 até 00:00 UTC. HarvestAPI não tem limite diário.
• Fetchin também não tem limite diário.
• Uma chamada que seu saldo não cobre responde 402. Adicione fundos, a partir de US$ 5, em seu painel.

Como Funciona

Etapa 1: Informe o custo, depois aguarde o sim do usuário

Cada consulta é paga com o saldo do usuário. Antes de qualquer consulta, mesmo uma única, informe qual provedor você usará e quanto custa (US$ 0,002375 por perfil através do Up2Data, US$ 0,0037 através do HarvestAPI, US$ 0,001485 através do Fetchin; para uma lista, o total), e aguarde o sim do usuário. Pergunte novamente antes de trocar de provedor ou adicionar URLs que o usuário não forneceu.

Etapa 2: Consulte o perfil através do Up2Data (o padrão)

Escolha Up2Data primeiro: um perfil que ele não consegue encontrar é gratuito. Envie o URL completo do perfil; Up2Data recusa um identificador público simples com um 400.

curl -s -X POST "https://api.datacircle.dev/v1/profiles/enrich" \
  -H "Authorization: Bearer $DATACIRCLE_API_KEY" \
  -H "X-Data-Provider: up2data" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/in/williamhgates"}' \
  | jq '{name: .data.full_name, headline: .data.headline, company: .data.current_company.name, positions: [.data.positions[]? | {title, company, started_at, ended_at}], cost: .datacircle_meta}'

O corpo também aceita fields (apenas os campos de nível superior de data, mesmo preço), with_followers_and_connections e with_full_skills_and_endorsements (mesmo preço, mais lento).

…