@denizhosgor/pagespeedinsight-mcp

Desteklenen Platformlar

Google PageSpeed Insights'i MCP tool olarak sunan Node.js paketidir.

Node.js Uyumlulugu

• Desteklenen Node.js surumleri: 20, 22, 24
• Lokal gelistirme varsayilani: en guncel Node.js 24 (.nvmrc = 24)

Kurulum

Global:

npm install -g @denizhosgor/pagespeedinsight-mcp

Calistirma:

pagespeedinsight-mcp

NPX:

npx -y @denizhosgor/pagespeedinsight-mcp

API Anahtari

Anahtari sadece ortam degiskeni olarak verin (chat/log icine yazmayin):

export GOOGLE_API_KEY="YOUR_KEY"
# Bu paket icin desteklenen alternatif ad:
export PAGESPEEDINSIGHT_API_KEY="YOUR_KEY"

Iki degisken birden varsa PAGESPEEDINSIGHT_API_KEY onceliklidir.

OpenClaw Kurulumu

1. Paketi OpenClaw plugin olarak kur (UI veya API ile) npm spec:

@denizhosgor/[email protected]

Bu paket openclaw.plugin.json ile skill'i otomatik ship eder:

• openclaw/skills/pagespeed_insights

2. MCP sunucusunu kaydet:

openclaw mcp set pagespeed-insights '{"command":"npx","args":["-y","@denizhosgor/pagespeedinsight-mcp"]}'

3. Skill yuklendigini kontrol et:

openclaw skills list

4. Yeni oturum acip runtime tool listesini kontrol et:

/new
/tools verbose

OpenClaw plugin kurulum akisinda degilsen manuel fallback kurulumu kullanabilirsin:

pagespeedinsight-mcp install-skill --openclaw-dir /absolute/path/to/openclaw --chown node:node

Allowlist Notu

OpenClaw tarafinda skill allowlist kullaniyorsan pagespeed_insights ekle:

{
  "agents": {
    "defaults": {
      "skills": ["pagespeed_insights"]
    }
  }
}

Mevcut Toollar

MCP (OpenClaw ve MCP istemcileri):

• run_pagespeed
• compare_pagespeed

Sadece Paperclip:

• check_plugin_version

Raporlama

• Her tool cagrisinda JSON rapor yazilir ve saved_report_path doner.
• Varsayilan rapor klasoru: <cwd>/report
• Dosya formati: <url>-<timestamp>.json
• Klasoru degistirmek icin: PAGESPEEDINSIGHT_REPORT_DIR=/custom/path

run_pagespeed sonucu: request_context, summary, opsiyonel raw, saved_report_path.

compare_pagespeed sonucu: request_context, mobile, desktop, performance_delta_desktop_minus_mobile, saved_report_path.

Paperclip Plugin Destegi

Bu paket Paperclip manifest + worker dosyalarini da icerir (src/manifest.ts, src/worker.ts).

• package.json > paperclipPlugin
• Worker girisi: dist/worker.js
• Manifest girisi: dist/manifest.js
• Yetkiler:
  • agent.tools.register
  • http.outbound
• Kayitli Paperclip toollari:
  • pagespeedinsight-mcp:run_pagespeed
  • pagespeedinsight-mcp:compare_pagespeed
  • pagespeedinsight-mcp:check_plugin_version

Health cevabinda otomatik registry surum kontrolu varsayilan kapali gelir. Gerekirse ac:

export PAGESPEEDINSIGHT_HEALTH_VERSION_CHECK=true

Guvenlik Notlari

• npm lifecycle install script'i (postinstall) yoktur.
• Varsayilan outbound host allowlist: www.googleapis.com
• Gerekirse allowlist degistir:

export PAGESPEEDINSIGHT_ALLOWED_OUTBOUND_HOSTS=www.googleapis.com

• HTTP hata cevaplari tool'a donmeden once sadeleştirilir.

OpenClaw Skill Dosyasi

• Repo yolu: openclaw/skills/pagespeed_insights/SKILL.md

Gelistirme ve Test

npm install
npm run build
npm run typecheck
npm run check
npm test

Guvenlik ve Yayin Oncesi Kontroller

npm run security:prod
npm run security:full
npm run release:check