A News Factory para desenvolvedores e agentes de IA

Tudo o que a News Factory faz com matérias, fontes de conteúdo, feeds RSS e fluxos de trabalho está disponível em uma REST API: encontre notícias do seu nicho, transforme artigos em matérias com IA, verifique a qualidade e o SEO, traduza e publique no seu site. A referência é pública e escrita para que tanto pessoas quanto agentes de IA possam usá-la por conta própria.

Documentação

  • Referência da API: guias e todos os endpoints, em uma página.
  • Especificação OpenAPI 3.1: gere um cliente ou entregue-a a um agente como ferramentas (cada operação tem um operationId).
  • llms.txt e llms-full.txt: a referência para grandes modelos de linguagem, como índice e como um único arquivo Markdown.
  • Servidor MCP em https://client-api.news-factory.app/mcp: conecte um agente de IA (Claude Code, Cursor, qualquer cliente MCP) com uma chave API e cada endpoint vira uma ferramenta.

Primeiros passos

  1. A API está incluída nos planos Pro, Business e Enterprise. Ver os planos.
  2. Um administrador da organização cria uma chave API no app, em “Definições da organização”, “Chaves API”, e escolhe o que ela pode fazer.
  3. Chame GET /v1/me com a chave: ele informa a organização, as permissões da chave e os espaços de trabalho temáticos que ela pode usar.
curl https://client-api.news-factory.app/v1/me \
  -H "Authorization: Bearer $NEWS_FACTORY_API_KEY"

Chaves API com permissões

Uma organização pode ter várias chaves, cada uma com apenas o acesso de que uma integração precisa, opcionalmente limitada a um espaço de trabalho temático e com data de expiração. As chaves são mostradas uma vez, guardadas apenas como hash e param de funcionar em até um minuto depois de revogadas.

PermissãoO que permite
stories:readLer matérias, as mídias delas e o histórico do Controle de qualidade e da auditoria SEO
stories:writeCriar, atualizar e excluir matérias; enviar, anexar e desanexar mídias; definir miniaturas
content-sources:readLer fontes de conteúdo
content-sources:writeCriar, atualizar, excluir e fazer scraping de fontes de conteúdo
feeds:readLer feeds seguidos, o catálogo de feeds, os artigos dos feeds e o status do agendador
feeds:writeSeguir e deixar de seguir feeds, buscar um feed agora
workflows:readLer fluxos de trabalho, execuções de fluxos e execuções de etapas
workflows:runIniciar, pausar, retomar e parar execuções de fluxos de trabalho
ai:generateUsar ferramentas de IA que gastam créditos de IA, junto com a permissão do que elas leem ou alteram

Pensada para agentes de IA

claude mcp add --transport http news-factory https://client-api.news-factory.app/mcp \
  --header "Authorization: Bearer $NEWS_FACTORY_API_KEY"

Veja na prática: o Claude Code cria um site de notícias no ar via MCP, com um único prompt, e cada passo em um vídeo curto.

  • Via MCP, uma chave só vê as ferramentas que as permissões dela liberam, e cada chamada passa pelas mesmas verificações da REST API.
  • Todo erro diz o que deu errado, o que fazer em seguida e traz um link para a explicação: { error: { code, message, details, requestId, docs } }.
  • Um erro de permissão lista exatamente quais permissões faltam; um erro de espaço de trabalho temático lista os válidos.
  • A referência inclui receitas passo a passo: escrever uma matéria a partir de um artigo da web, verificá-la e melhorá-la, traduzi-la, escolher notícias relevantes dos feeds seguidos, executar um fluxo de trabalho e aguardar a conclusão.
  • Os limites de requisições vêm com os cabeçalhos Retry-After e RateLimit, para que um agente possa controlar o próprio ritmo.

Dúvidas

Escreva para support@news-factory.app e inclua o requestId da resposta sobre a qual você está perguntando.