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
- A API está incluída nos planos Pro, Business e Enterprise. Ver os planos.
- 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.
- Chame
GET /v1/mecom 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ão | O que permite |
|---|---|
stories:read | Ler matérias, as mídias delas e o histórico do Controle de qualidade e da auditoria SEO |
stories:write | Criar, atualizar e excluir matérias; enviar, anexar e desanexar mídias; definir miniaturas |
content-sources:read | Ler fontes de conteúdo |
content-sources:write | Criar, atualizar, excluir e fazer scraping de fontes de conteúdo |
feeds:read | Ler feeds seguidos, o catálogo de feeds, os artigos dos feeds e o status do agendador |
feeds:write | Seguir e deixar de seguir feeds, buscar um feed agora |
workflows:read | Ler fluxos de trabalho, execuções de fluxos e execuções de etapas |
workflows:run | Iniciar, pausar, retomar e parar execuções de fluxos de trabalho |
ai:generate | Usar 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-AftereRateLimit, 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.