← Updates

Public API e MCP 2.4: filtros, anotações, share e SEO enrich

Filtros guardados, tags e notas em relatórios, links de partilha para convidados e recarga de métricas SEO — na REST API e MCP. 31 ferramentas em vez de 21, a mesma API key.

A Public API e o servidor MCP passam a suportar o fluxo de trabalho completo do relatório — antes só na aplicação web. Uma chave Bearer em Perfil → Definições; o limite de 60 pedidos por minuto é partilhado entre REST e MCP.

No MCP há agora 31 ferramentas (antes 21). Novo grupo Report workflow — os endpoints REST estão agrupados da mesma forma: Reports, Account, Report workflow, Live checkers.

Filtros guardados

Guarde um conjunto de filtros de pesquisa por nome e chame-o a partir de um script ou do chat.

  • REST: GET / PUT / DELETE /v1/user/saved-filters
  • MCP: list_saved_filters, save_saved_filter, delete_saved_filter

Anotações e tags

Notas até 200 caracteres e até 10 tags por relatório — para shortlists, CRM e trabalho em equipa.

  • REST: GET /v1/reports/annotations/tags, GET / PUT / DELETE /v1/reports/annotations
  • MCP: list_annotation_tags, get_report_annotation, set_report_annotation, delete_report_annotation

Links de partilha para convidados

Envie um relatório a um colega ou cliente sem acesso à conta.

  • REST: POST /v1/reports/share → share_url na resposta
  • MCP: create_share_link

No corpo do pedido: report_type e report_id da pesquisa ou do relatório completo.

SEO enrich via API

O carregamento de métricas SEO em falta está agora disponível de forma programática — fora da fila do sistema, como na página do relatório.

  • REST: POST /v1/reports/{report_type}/{report_id}/enrich-seo (resposta 202 + job_id), depois GET /v1/reports/enrich-jobs/{job_id} até ao estado done
  • MCP: enrich_report_seo, get_enrich_report_seo_job

Se o MCP já estiver ligado

URL e chave não precisam de mudar. O cliente guarda a lista de ferramentas por sessão — abra um chat novo ou reinicie o Cursor / Claude / ChatGPT. As novas rotas REST ficam disponíveis de imediato.

Detalhes, exemplos curl e esquemas de campos — nas landing pages atualizadas API e MCP; esquema completo na Swagger UI.