# Blog pessoal

Escrever e publicar artigos por seções, com arquivos e tradução para espanhol, inglês e português.

Fonte: https://ardumaker.com/pt/docs/blog-personal/

- Categoria: Comunidade e serviços adicionais
- Estado: Disponível
- Requisitos: Permissão de blog ativada na conta por um administrador da ArduMaker
- Ferramentas MCP (Só leem): `listar_blogs`, `ver_blog`, `listar_mis_blogs`, `ver_mi_blog`, `listar_media_blog`
- Ferramentas MCP (Escrevem ou modificam): `crear_blog`, `editar_blog`, `publicar_blog`, `despublicar_blog`, `traducir_blog`, `agregar_seccion_blog`, `crear_media_blog`
- Ferramentas MCP (Destrutivas): `eliminar_seccion_blog`, `eliminar_media_blog`

## O que permite fazer?

- Criar um artigo com título, descrição, etiquetas e imagem de capa.
- Montá-lo por seções do tipo `text`, `image`, `video`, `audio`, `code`, `quote` ou `file`.
- Carregar arquivos para o artigo.
- Traduzir título e textos para `es`, `en` e `pt`.
- Publicá-lo, arquivá-lo e voltar a publicá-lo.

## Quando convém usar?

Para escrever guias, novidades ou tutoriais que aparecem no site público e no [perfil](https://ardumaker.com/pt/docs/perfiles-publicos) da pessoa.

## Como funciona na ArduMaker?

1. O artigo nasce como rascunho: só o autor o vê.
2. Adicionam-se seções com uma chave própria (letras, números e underscores). Uma chave repetida é recusada: para substituir uma seção é preciso apagá-la antes.
3. A tradução chama um serviço externo por cada texto e só volta a traduzir o que está desatualizado.
4. Publicar torna-o visível e fixa a data de publicação na primeira vez. Arquivar retira-o das listagens e é reversível.

| Ficheiros | Regra |
| --- | --- |
| Tamanho | Até 10 MB por arquivo |
| Extensões | jpg, jpeg, png, gif, webp, mp4, webm, ogg, mp3, wav, pdf, txt, md |

## O que muda realmente?

O artigo, as seções, as traduções e os arquivos são guardados na ArduMaker. Os artigos publicados aparecem na listagem pública, que se filtra por autor, etiqueta ou texto.

> **PELIGRO:** Eliminar um artigo é definitivo e apaga também os arquivos. Para o retirar de circulação sem o perder, convém arquivá-lo.

## Resultado esperado

Um artigo público, acessível pelo id ou slug, no idioma pedido se tiver tradução.

## Erros e resolução

- **403 ao criar**: a conta não tem permissão de blog.
- **409 `seccion_ya_existe`**: já existe uma seção com essa chave.
- **Ficheiro recusado**: extensão não aceite ou mais de 10 MB.
- **424 `Translation failed`**: o serviço de tradução falhou. É seguro repetir.

## Relação com MCP

Um agente pode escrever e publicar os blogs do seu dono se este tiver permissão de blog. Ler blogs publicados não requer permissão especial. Ver [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

| Tipo | Ferramentas |
| --- | --- |
| Leitura | `listar_blogs`, `ver_blog`, `listar_mis_blogs`, `ver_mi_blog`, `listar_media_blog` |
| Modificam | `crear_blog`, `editar_blog`, `publicar_blog`, `despublicar_blog`, `traducir_blog`, `agregar_seccion_blog`, `crear_media_blog` |
| Destrutivas | `eliminar_seccion_blog`, `eliminar_media_blog` |

Apagar um artigo inteiro não está disponível via MCP. `eliminar_media_blog` não verifica se alguma seção usa o arquivo.

## Funcionalidades relacionadas

- [Perfis públicos](https://ardumaker.com/pt/docs/perfiles-publicos/)
- [Programa de criadores](https://ardumaker.com/pt/docs/programa-de-creadores/)
- [Servidor MCP](https://ardumaker.com/pt/docs/servidor-mcp/)