Hermes Agent untuk SEO: Hubungkan Search Console, DataForSEO, dan Buat SEO Skills
Pencarian web membuat Hermes Agent bisa membaca halaman, bukan mengukurnya. Panduan ini menambahkan lapisan data: Google Search Console lewat MCP server mcp-gsc, data keyword dan SERP lewat DataForSEO, rutinitas SEO yang dikemas jadi skill, dan laporan mingguan terjadwal, lengkap dengan blok config.yaml dan file SKILL.md yang bisa langsung disalin.
- #hermes-agent
- #google-search-console
- #dataforseo
- #mcp
- #seo-automation
- #ai-agent-skills
- #seo-reporting
Tools apa saja yang dibutuhkan setup SEO Hermes Agent?
| Layer | What it gives the agent | How you connect it | Needed? |
|---|---|---|---|
| Pencarian + ekstraksi web | Live pages and search results | API key in ~/.hermes/.env (guide 1) | Yes |
| Google Search Console | Your clicks, impressions, CTR, positions, URL inspection, sitemaps | mcp-gsc MCP server (MIT, community-built) | Yes, for sites you own |
| DataForSEO | Keyword, SERP, and other DataForSEO API data | dataforseo-mcp-server (Apache-2.0) | Optional, paid API |
| Browser tools | Rendered pages on JavaScript-heavy sites | hermes tools → browser toolset | For JS-rendered sites |
| Skills | Repeatable procedures with your rules | SKILL.md files in ~/.hermes/skills/ | Yes |
| Cron | Unattended scheduled runs | hermes cron create | Optional |
| Memori | Site context and past findings across sessions | Built in (MEMORY.md, USER.md) | Built in |
Bagaimana cara menghubungkan data SEO dan skills ke Hermes Agent?
- 1
Nyalakan toolset yang dibutuhkan kerja SEO
Jalankan hermes tools lalu aktifkan web, browser, file, terminal, skills, memory, dan cronjob. Matikan toolset yang tidak relevan (Spotify, Home Assistant, Discord admin): daftar tool yang lebih pendek berarti model punya lebih sedikit pilihan saat memutuskan tool apa yang dipanggil. Untuk satu session saja, Anda juga bisa langsung memberi daftar dengan hermes chat --toolsets.
Terminal hermes tools # or, for a single session hermes chat --toolsets "web,browser,file,skills,memory"
- 2
Buat kredensial Google Cloud untuk Search Console
Di Google Cloud Console, buat project, aktifkan Search Console API, lalu buat kredensial. Ada dua pilihan. OAuth client login sebagai Anda dan bisa melihat semua properti yang bisa diakses akun Google Anda. Service account hanya melihat properti tempat email-nya Anda tambahkan sebagai user di Search Console, yang menurut README mcp-gsc butuh akses penuh. Untuk agent, service account adalah kebiasaan yang lebih baik: Anda menentukan persis situs mana yang boleh dibaca. Simpan file JSON yang diunduh di lokasi permanen dan di luar repo git mana pun.
- 3
Instal mcp-gsc dan daftarkan di config.yaml
Instal uv, clone mcp-gsc, lalu tambahkan di bawah mcp_servers pada ~/.hermes/config.yaml (blok lengkapnya ada di contoh di bawah). mcp-gsc butuh Python 3.11 atau lebih baru. Detail yang gampang terlewat: Hermes menghapus environment variable dari subprocess MCP dan hanya meneruskan variable sistem yang aman plus apa yang Anda tulis di blok env server tersebut, jadi GSC_CREDENTIALS_PATH yang di-export di shell tidak akan pernah sampai ke server. Biarkan GSC_ALLOW_DESTRUCTIVE tidak diisi agar agent tidak bisa menjalankan operasi Search Console yang destruktif. Lalu ketik /reload-mcp di chat dan minta agent menampilkan daftar properti Anda.
Terminal curl -LsSf https://astral.sh/uv/install.sh | sh git clone https://github.com/AminForou/mcp-gsc.git ~/mcp/mcp-gsc cd ~/mcp/mcp-gsc uv venv .venv uv pip install -r requirements.txt
- 4
Tambahkan DataForSEO untuk data keyword dan SERP
Buat akun DataForSEO, salin kredensial API Anda, lalu tambahkan dataforseo-mcp-server resmi ke config.yaml dengan DATAFORSEO_LOGIN dan DATAFORSEO_PASSWORD di blok env-nya. Server ini jalan lewat npx, jadi Node.js harus ada di PATH. DataForSEO adalah API berbayar: cek harganya sebelum meminta agent melakukan apa pun dalam jumlah besar, dan mulai dari satu keyword untuk melihat apa yang dikembalikan satu request. Agent yang mengulang dalam loop bisa mengirim request jauh lebih banyak dari perkiraan. Kalau tidak mau menjalankan server lokal, DataForSEO juga menyediakan versi hosted di https://mcp.dataforseo.com/v3/mcp dengan OAuth.
- 5
Cari di skills hub sebelum menulis sendiri
Cari SEO skill yang sudah ada dengan hermes skills search seo, baca SKILL.md-nya sebelum menginstal, dan instal hanya yang cocok dengan cara kerja Anda. Skill di hub berasal dari repo resmi Hermes, skills.sh milik Vercel, repo GitHub, dan situs yang menerbitkan indeks skill. Setiap instalasi dari hub melewati security scanner yang memeriksa eksfiltrasi data, prompt injection, dan perintah destruktif. Lolos scan berarti skill itu tidak jelas-jelas berbahaya, bukan berarti saran SEO-nya bagus. Menurut kami: checklist publik yang generik cocok sebagai titik awal, dan skill buatan sendiri lebih unggul karena membawa aturan situs Anda.
Terminal hermes skills search seo hermes skills browse hermes skills install <identifier> # after reading its SKILL.md hermes skills list
- 6
Tulis skill audit on-page
Buat ~/.hermes/skills/seo/page-audit/SKILL.md dengan frontmatter YAML (name, description, version, tags, toolset yang dibutuhkan) dan isi yang menjabarkan prosedur, format output, dan jebakan yang perlu dihindari. Skill di-load sesuai kebutuhan, jadi description-lah yang menentukan kapan Hermes memakainya; tulis sebagai tugas yang benar-benar akan diminta orang. Uji dengan /page-audit diikuti URL. Pakai selama seminggu dan tambahkan satu baris di Pitfalls setiap kali output-nya meleset. Hermes juga bisa membuat dan menambal skill sendiri setelah tugas yang kompleks; set skills.write_approval ke true kalau Anda ingin me-review perubahan itu sebelum disimpan.
- 7
Tulis skill laporan mingguan Search Console
Buat skill kedua, gsc-weekly-report, yang membandingkan 7 hari terakhir dengan 7 hari sebelumnya lewat mcp-gsc dan mengembalikan laporan singkat dengan format tetap. Format tetap lebih penting daripada analisis yang canggih: laporan yang bentuknya sama setiap minggu bisa dibaca dalam dua menit dan dibandingkan dengan minggu lalu. Beri tahu skill perubahan seperti apa yang dianggap penting dan tetapkan batas minimal impresi agar noise dari query kecil diabaikan. Ingat bahwa data Search Console yang baru masih bisa berubah. GSC_DATA_STATE di mcp-gsc default-nya all, yang menyertakan data terbaru; ubah ke final untuk hanya memakai data yang sudah final.
- 8
Jadwalkan laporan dengan hermes cron
Buat job dengan hermes cron create, jadwal, prompt, dan --skill gsc-weekly-report. Hermes menerima jadwal bahasa natural seperti "every monday 9am" maupun ekspresi cron seperti "0 9 * * 1". Setiap run disimpan di ~/.hermes/cron/output/, dan setelah messaging gateway disiapkan, --deliver bisa mengirim hasilnya ke Telegram, Slack, Discord, atau email. Sebelum run pertama tanpa pengawasan, cek pengaturan approval (ada cron_mode tersendiri) dan jalankan job sekali secara manual dengan hermes cron run supaya Anda membaca output-nya sebelum orang lain.
Terminal hermes cron create "every monday 9am" "Run the weekly Search Console report for sc-domain:example.com and save it to ~/seo/example-com/reports/" --skill gsc-weekly-report --name gsc-weekly hermes cron list hermes cron run <job-id> # test once by hand
File config dan skill yang siap disalin
mcp_servers:
gsc:
command: "/Users/you/mcp/mcp-gsc/.venv/bin/python"
args: ["/Users/you/mcp/mcp-gsc/gsc_server.py"]
env:
GSC_CREDENTIALS_PATH: "/Users/you/keys/gsc-service-account.json"
GSC_SKIP_OAUTH: "true"
GSC_DATA_STATE: "all"
dataforseo:
command: "npx"
args: ["-y", "dataforseo-mcp-server@latest"]
env:
DATAFORSEO_LOGIN: "your-api-login"
DATAFORSEO_PASSWORD: "your-api-password"Pakai path absolut. Kredensial harus ada di setiap blok env karena Hermes tidak meneruskan environment shell ke MCP server, jadi perlakukan config.yaml sebagai file rahasia juga: chmod 600 dan jangan masuk git. Jalankan /reload-mcp di chat setelah mengedit.
---
name: page-audit
description: Audit one URL for on-page SEO issues using the live page and Search Console data
version: 1.0.0
metadata:
hermes:
tags: [seo, audit]
category: seo
requires_toolsets: [web]
---
# On-page SEO audit
## Procedure
1. Fetch the live URL. Quote title, meta description, canonical, robots meta, H1, and H2s.
2. Pull the last 28 days of queries for this URL from Search Console.
3. Check whether the top 5 queries by impressions appear in the title, H1, or first paragraph.
## Output (always this format)
| Element | Current | Issue | Fix | Evidence |
Evidence is a quoted element or a Search Console figure with its date range.
## Never
- Estimate traffic or search volume without a tool result
- Recommend changes to pages other than the given URL
- Rewrite the whole page; propose the specific edit
## Pitfalls (add a line after every bad run)
- Search Console URLs can differ from the live URL by trailing slash or locale prefix; match both
- A plain fetch can miss JavaScript-rendered content; use the browser tool if the body looks emptyBagian Pitfalls sengaja dimulai pendek. Isinya bertambah dari kesalahan nyata, dan itu yang membuat skill ini lebih baik daripada checklist generik.
---
name: gsc-weekly-report
description: Weekly Google Search Console report comparing the last 7 days with the previous 7
version: 1.0.0
metadata:
hermes:
tags: [seo, reporting, search-console]
category: seo
---
# Weekly Search Console report
## Procedure
1. Compare the last 7 days with the previous 7 days for the given property.
2. Report site totals: clicks, impressions, CTR, average position, each with % change.
3. List the 5 pages with the largest click loss and the 5 with the largest gain.
4. For each page, list the queries behind the change. Skip queries under 100 impressions in both periods.
## Output
- A 5-line summary first: numbers only, no adjectives
- Then the two tables
- End with at most 3 things worth checking, each tied to a row above
## Never
- Blame a change on an algorithm update without a source
- Round or estimate figures; copy them from the tool output
- Call a single week-over-week change a trendBatas 100 impresi hanya titik awal, bukan aturan. Naikkan untuk situs besar, turunkan untuk situs kecil.
Pertanyaan yang sering diajukan
Bagaimana cara menghubungkan Google Search Console ke Hermes Agent?
Buat project Google Cloud, aktifkan Search Console API, dan unduh kredensial OAuth atau service account. Clone server open-source mcp-gsc lalu tambahkan di bawah mcp_servers pada ~/.hermes/config.yaml, dengan path kredensial di dalam blok env-nya. Jalankan /reload-mcp di chat dan minta agent menampilkan daftar properti untuk memastikan koneksinya jalan.
Kenapa MCP server bilang kredensial tidak ada padahal sudah di-set di shell?
Hermes tidak meneruskan environment shell ke MCP server. Subprocess MCP hanya menerima variable sistem yang aman seperti PATH dan HOME, plus apa pun yang Anda tulis di blok env server itu di config.yaml. Pindahkan variable-nya ke env lalu jalankan /reload-mcp.
Apa itu skill di Hermes Agent?
Skill adalah folder di ~/.hermes/skills/ yang berisi file SKILL.md: frontmatter YAML (name, description, version, tags) diikuti instruksi dalam markdown. Hermes memuatnya saat tugas cocok, atau saat Anda mengetik namanya sebagai slash command seperti /page-audit. Skill mengikuti standar terbuka agentskills.io, dan Hermes bisa membuat serta menambal skill-nya sendiri setelah tugas yang kompleks.
Apakah perlu DataForSEO, atau Search Console sudah cukup?
Search Console cukup untuk mengoptimasi halaman yang sudah dapat impresi, karena ia menampilkan query tempat Anda sudah muncul. Ia tidak bisa menunjukkan keyword yang belum Anda tempati atau siapa yang menguasai hasil teratas, dan itulah yang ditambahkan data keyword dan SERP dari DataForSEO. Mulai dengan Search Console saja, lalu tambahkan DataForSEO saat merencanakan konten baru.
Bisakah Hermes Agent mengirim laporan SEO ke Slack atau Telegram otomatis?
Bisa. Siapkan messaging gateway dengan hermes gateway setup, lalu buat cron job dengan --deliver slack atau --deliver telegram. Pengiriman cron juga mendukung Discord dan email. Gateway menolak semua user sampai Anda mengatur allowlist, jadi tambahkan diri Anda dulu sebelum menunggu pesan masuk.
Perlukah membiarkan agent mengubah sesuatu di Search Console?
Kami tidak menyarankannya. mcp-gsc mematikan operasi destruktif kecuali GSC_ALLOW_DESTRUCTIVE di-set ke true, dan service account yang dibatasi ke properti pilihan Anda makin mempersempit risikonya. Biarkan agent membaca dan memberi rekomendasi, lalu lakukan perubahannya sendiri.
Poin utama
Lapisan data mengubah Hermes Agent dari pembaca halaman menjadi tool SEO. Hubungkan Search Console lewat mcp-gsc dengan service account yang dibatasi ke properti Anda, tambahkan DataForSEO saat butuh data keyword dan SERP di luar data sendiri, dan taruh setiap kredensial di blok env MCP server, karena Hermes tidak meneruskan environment shell. Kemas rutinitas menjadi skill dengan format output tetap dan bagian Pitfalls yang diperbarui setiap kali hasilnya meleset. Jadwalkan job hanya setelah Anda menjalankannya manual dan membaca hasilnya.