Hubungkan ke Hermes Agent

Kanzen Ads nyambung ke NousResearch hermes-agent sebagai sumber belajar dan produksi konten lewat MCP (Model Context Protocol). Agent yang jalanin panggilan Meta Marketing API-nya sendiri — Kanzen Ads gak pernah nyentuh Meta atas nama agent.

Kanzen Ads itu apa buat si agent

Kanzen Ads bukan driver Meta buat agent. Ini permukaan produksi konten:

• Permukaan produksi konten. Agent bikin produk di Kanzen Ads, generate gambar/video buat produk itu, poll sampai medianya siap, terus ambil URL file hasilnya dan upload sendiri ke Meta pakai tools dan kredensial Meta miliknya sendiri.

Install / hubungkan

Unduh file client-nya, arahin ke deployment Kanzen Ads lo, terus daftarin lewat CLI agent.

curl -O https://kanzenads.com/api/mcp/hsl_mcp.py

export HERMES_API_KEY="hsk_your_key"
export AIBUDDY_GEN_URL="https://kanzenads.com"

hermes mcp add hsl --command "python hsl_mcp.py"

Tools MCP-nya

Empat keluarga: system, produksi-konten, knowledge, dan CEP.

Bikin CEP di produk

CEP (Customer Entry Point) itu potongan intelijen copy/angle singkat — pain point-nya dan angle yang disaranin — yang ditempelin ke sebuah produk atau topik. Pakai ini buat nyerahin hasil riset agent sendiri balik ke Kanzen Ads sebagai input kreatif, sebelum generate gambar/video dari situ.

curl -X POST https://<your-hsl-domain>/api/hermes/ceps \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "cepText": "Kulit kusam bikin gak pede difoto",
    "productId": "<PRODUCT_ID>",
    "painPoint": "kulit kusam",
    "angle": "before/after glow-up"
  }'

{
  "cep": {
    "id": "<CEP_ID>",
    "cepText": "Kulit kusam bikin gak pede difoto",
    "painPoint": "kulit kusam",
    "angle": "before/after glow-up",
    "status": "active",
    "productId": "<PRODUCT_ID>",
    "createdAt": "2026-01-01T00:00:00.000Z"
  },
  "message": "CEP created and active"
}

Liat apa yang udah ada buat sebuah produk pakai GET /api/hermes/ceps?productId=<id> (atau ?topicId=<id>), header Authorization yang sama.

Generate → masuk Media Library produk

POST /api/gen/image dan POST /api/gen/video sama-sama nerima productId opsional di request body. Kalau diisi, begitu job generate-nya selesai, gambar/video hasilnya otomatis ditempelin ke media library produk itu — gak ada langkah simpan terpisah.

curl -X POST https://<your-hsl-domain>/api/gen/image \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Produk skincare di atas meja kayu, natural light",
    "productId": "<PRODUCT_ID>",
    "size": "3:2",
    "n": 1
  }'

Belum set productId waktu submit (atau asset-nya di-generate di tempat lain)? Tempelin belakangan aja — liat mcp_hsl_attach_media / POST /api/gen/products/<id>/attach pakai generatedMediaId yang udah completed.

Liat semua yang udah lo generate (yang nempel ke produk atau nggak) pakai GET /api/gen/media — hasilnya di-scope ke akun lo sendiri.

Loop produksi konten

Agent yang nyetir loop ini end-to-end; Kanzen Ads cuma produksi dan nyimpen kreatifnya. Agent yang ngomong ke Meta.

Skills tap (prosedur)

Tools MCP di atas itu kapabilitasnya. Kanzen Ads juga nyediain skills tap — sekumpulan prosedur SKILL.md yang ngajarin agent kapan dan gimana cara gabungin tools-tools itu buat sebuah task pertumbuhan, terus serahin ke Meta. Skills cuma muncul kalau toolset Kanzen Ads udah connect (dia deklarasiin requires_toolsets: [hsl]).

Skills-nya ada di repo ini di bawah hermes-skills/skills/, jadi tambahin tap-nya pakai override path:

# add the tap (skills are under hermes-skills/skills, not repo-root skills/)
hermes skills tap add boysoutheast/kanzen-ads
# → then set "path": "hermes-skills/skills" for this tap in ~/.hermes/.hub/taps.json

hermes skills install boysoutheast/kanzen-ads/produce-product-creative
hermes skills install boysoutheast/kanzen-ads/learn-before-launch
hermes skills install boysoutheast/kanzen-ads/scale-a-winner
hermes skills install boysoutheast/kanzen-ads/top-up-creatives
hermes skills install boysoutheast/kanzen-ads/pause-underperformer

Memory provider (opsional)

Buat integrasi yang lebih dalam, Kanzen Ads jalan sebagai memory provider native hermes-agent — Kanzen Ads jadi backend memory performa-terverifikasi milik agent. Otomatis nyuntikin blok recall sebelum tiap turn dan nambahin tools hsl_recall. Plugin-nya ada di plugins/hermes-memory-hsl/ (Python stdlib doang).

# drop-in install
cp -r plugins/hermes-memory-hsl ~/.hermes/plugins/hermes-memory-hsl
export HSL_API_KEY="hsk_your_key"
export HSL_API_BASE="https://kanzenads.com"   # optional, this is the default
hermes memory setup   # select "hsl"

Skills tap dan memory provider itu saling melengkapi: tap ngasih agent prosedur, provider-nya ngasih recall ambient. Pakai salah satu atau dua-duanya — dua-duanya tetep nyerahin eksekusi Meta sepenuhnya ke agent.