📂 Sites estáticos via GitHub API

Um Static Site Generator (SSG) lê arquivos Markdown e cospe HTML pronto. Não tem banco, não tem PHP, não tem runtime no servidor — o site é uma pasta de .html servida por CDN. Os quatro líderes têm perfis bem diferentes:

Para escrever em um repositório via API, você precisa de um Personal Access Token (PAT). É uma string que substitui senha em chamadas HTTP. Existem dois tipos: Classic (escopos amplos, mais antigo) e Fine-grained (por repo, recomendado em 2026).

Caminho: github.com → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Defina expiração curta (30-90 dias), restrinja ao repo do blog e marque os escopos mínimos.

Escopos necessários (Fine-grained)

O endpoint PUT /repos/{owner}/{repo}/contents/{path} cria ou atualiza um arquivo. O corpo precisa do conteúdo codificado em Base64 (não Markdown puro) e uma mensagem de commit. Para atualizar, mande também o sha do arquivo atual.

# Criar arquivo content/posts/2026-05-24-meu-post.md
CONTENT_B64=$(printf '%s' '---
title: "Meu primeiro post via API"
date: 2026-05-24
tags: [api, automacao]
---

Conteúdo do post em **Markdown**.' | base64 -w0)

curl -X PUT \
  -H "Authorization: Bearer ghp_SEU_TOKEN_AQUI" \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/repos/SEU_USER/meu-blog/contents/content/posts/2026-05-24-meu-post.md \
  -d "{
    \"message\": \"post: meu primeiro post via API\",
    \"content\": \"$CONTENT_B64\",
    \"branch\": \"main\"
  }"

Resposta 201 Created com o commit.sha e o content.sha. Guarde esse sha — você precisa dele para editar o mesmo arquivo depois (manda no body como "sha": "...").

Campos do body

Frontmatter é o cabeçalho YAML entre duas linhas --- no topo do .md. Hugo/Jekyll/Astro leem essas chaves como metadados do post: título, data, tags, autor, draft, capa.

---
title: "Como automatizei meu blog via GitHub API"
date: 2026-05-24T10:30:00-03:00
draft: false
author: "AutomationsAI"
tags:
  - automacao
  - github
  - hugo
categories: ["devops"]
cover:
  image: "/img/covers/api-blog.png"
  alt: "Diagrama do pipeline"
summary: "Pipeline n8n → GitHub API → Hugo → Pages, em 30 minutos."
---

# Introdução

O fluxo que vou mostrar **não exige editor**: o post chega via webhook,
o n8n monta o Markdown, dá `PUT` na API e a Action faz o resto.

## Por que isso importa

- Zero atrito para publicar
- Histórico completo no git
- Custo zero de hospedagem

```bash
echo "código inline funciona normal"
```

Quando seu PUT cria o arquivo, o GitHub dispara o evento push. Um workflow em .github/workflows/deploy.yml escuta esse evento, builda o SSG e publica em Pages. Você não toca em nada — o site sai no ar em ~60s.

# .github/workflows/deploy.yml
name: pages-build-deployment

on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0   # Hugo precisa do histórico p/ lastmod

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: "0.140.0"
          extended: true

      - name: Build
        run: hugo --minify --baseURL "${{ steps.pages.outputs.base_url }}/"

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v4

WordPress, Ghost e similares são ótimos para quem edita post manualmente. Mas para um pipeline automatizado, o blog estático ganha em quatro frentes objetivas: