convez.ai
MCP ServerDados & AnalyticsIntermediário
legal1uhbvn-source

GSC PAP Claude – Motor de Inteligência SEO

legal1uhbvn-source/gsc-pap-claude-dashboard

Orquestrador de dados SEO que sintetiza GSC, GA4 e PSI em insights estratégicos

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server que integra Google Search Console, GA4 e PageSpeed Insights para gerar análises SEO narrativas e acionáveis via Claude AI. Transforma dados brutos em recomendações estratégicas conectando visibilidade de busca, comportamento de usuários e performance técnica sem configuração complexa de cloud.

Instalação

$npx convez-ai legal1uhbvn-source/gsc-pap-claude-dashboard

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise integrada de performance de website conectando busca, usuário e velocidade
  • Priorização de otimizações SEO baseada em impacto de negócio
  • Geração automatizada de relatórios estratégicos em PDF/email para stakeholders
  • Identificação de desconexões entre performance de busca e conversões

Veredito

Ferramenta bem construída que resolve um problema real: transformar dados SEO silotados em narrativa coerente. A abordagem de orquestração via Claude é inteligente, mas depende fortemente de credenciais de API válidas e exige perfis YAML bem estruturados. Melhor para profissionais SEO/marketing que já gerenciam múltiplas fontes de dados.

README

A tradução para o português deste README ainda está na fila.

GSC PAP Claude Plugin – Next-Gen SEO Intelligence Engine

Download

Unlock the Hidden Narrative of Your Website’s Performance

Most SEO tools show you data. This plugin teaches you what that data means. Imagine having a digital strategist who reads Google Search Console, GA4, and PageSpeed Insights simultaneously, then synthesizes a coherent story about your website’s health, opportunities, and threats—all without requiring you to configure a single cloud project. That’s the promise of the GSC PAP Claude Plugin.

This is not another dashboard aggregator. It is an intelligent orchestration layer that transforms raw metrics into actionable, narrative-driven insights. Think of it as the conductor of your website’s performance orchestra, ensuring every instrument—search visibility, user behavior, and technical speed—plays in perfect harmony.


Why This Plugin Exists (And Why It Matters)

The modern web professional is drowning in data. Google Search Console shows you clicks and impressions. GA4 shows you user paths and conversions. PageSpeed Insights shows you load times and Core Web Vitals. But no single tool tells you:

  • Why did my clicks drop after my site speed improved?
  • Which pages have high traffic but low conversion potential?
  • How should I prioritize fixes between a slow-loading product page and a high-bounce blog post?

The GSC PAP Claude Plugin bridges this interpretive gap. It uses Anthropic’s Claude API (with optional OpenAI fallback) to generate human-readable, strategic reports that connect these three data sources into a unified performance narrative.


The Three-Legged Stool of Modern SEO

At its core, the plugin operates on a simple but powerful premise: your website’s success rests on three interconnected pillars. Think of them as a three-legged stool—remove one, and the entire structure collapses.

graph TD
    A[Google Search Console] -->|Query & Click Data| D[Claude AI Engine]
    B[Google Analytics 4] -->|User Behavior & Conversions| D
    C[PageSpeed Insights] -->|Core Web Vitals & Performance| D
    D -->|Synthesized Narrative| E[Strategic Recommendations]
    D -->|Priority Matrix| F[Actionable Insights]
    D -->|Automated Reports| G[PDF/Email Delivery]
    style A fill:#f9f,stroke:#333,stroke-width:2px
    style B fill:#bbf,stroke:#333,stroke-width:2px
    style C fill:#bfb,stroke:#333,stroke-width:2px
    style D fill:#ff9,stroke:#333,stroke-width:2px

Example Profile Configuration

The plugin uses a YAML-based profile system that feels like writing a recipe for your digital kitchen. Here’s how a typical setup looks:

profile:
  name: "Ecommerce Growth Audit"
  site_url: "https://yourstore.com"
  data_sources:
    gsc:
      query_limit: 1000
      date_range: "last_28_days"
    ga4:
      property_id: "123456789"
      metrics: ["sessions", "conversionRate", "averageSessionDuration"]
    pagespeed:
      devices: ["mobile", "desktop"]
      categories: ["performance", "accessibility", "seo"]

  ai_config:
    engine: "claude-3-opus"
    temperature: 0.3
    max_tokens: 4000
    system_prompt: |
      You are an expert SEO strategist. Analyze the provided data and:
      1. Identify the top 3-5 disconnects between search performance and user behavior
      2. Prioritize technical fixes based on business impact
      3. Suggest content opportunities where search demand exceeds current engagement

  output_format:
    report_type: "executive_summary"
    include_graphs: true
    language: "en"

Example Console Invocation

Once configured, running an analysis is as simple as a single command. The plugin handles authentication, data fetching, and AI processing automatically:

python gsc_pap_claude.py --profile ecommerce_audit --output ./reports/february_2026.html --notify slack

Within seconds, you’ll see:

  • Data Collection: The plugin silently authenticates with GSC, GA4, and PageSpeed APIs.
  • Synthesis Phase: Claude processes the combined data, looking for patterns a human would miss.
  • Report Generation: A clean, branded HTML report appears in your output directory.

Emoji OS Compatibility Table

This plugin is designed to work everywhere your work does. Here’s how it behaves across operating systems:

Operating SystemStatusNotes
Windows 10/11✅ Fully SupportedWorks with Python 3.9+ and WSL2
macOS Ventura+✅ Fully SupportedNative ARM and Intel support
Ubuntu 22.04+✅ Fully SupportedProduction-tested on DigitalOcean droplets
Debian 11+✅ Fully SupportedRequires libffi-dev for SSL
Fedora 38+✅ Fully SupportedTested with Podman and Docker
Raspberry Pi OS⚠️ LimitedWorks but large reports may tax memory
Android (Termux)❌ Not SupportedPython environment limitations
iOS (a-Shell)❌ Not SupportedNo background process support

Feature List – The Swiss Army Knife of SEO Analysis

Every feature in this plugin was built to solve a specific gap in the current SEO tooling ecosystem. Consider this your feature map:

  • Multi-Source Data Fusion: Combines GSC, GA4, and PageSpeed into one coherent dataset without requiring a Google Cloud Project.
  • Narrative AI Engine: Uses Claude API (with OpenAI API fallback) to generate plain-English insights, not just charts.
  • Responsive UI Reports: Outputs beautifully formatted HTML that works equally well on desktop monitors and mobile phones.
  • Multilingual Support: Generate reports in 12+ languages including English, Spanish, German, French, Japanese, and Arabic (right-to-left support included).
  • Automated Scheduling: Run weekly reports automatically using cron or Task Scheduler.
  • Priority Matrix Visualization: See which issues to fix first, ranked by potential business impact.
  • Historical Trend Analysis: Compare current performance against previous periods to spot trends.
  • Competitor Benchmarking: Upload competitor domains for side-by-side comparison (GSC data required).
  • 24/7 Customer Support: While this is open-source, our community maintainers and Discord channel offer near-real-time assistance.
  • Zero Infrastructure: No need to spin up a GCP project, configure service accounts, or manage credentials. The plugin handles OAuth flow automatically.

SEO-Friendly Keyword Integration (Naturally Placed)

Throughout this documentation, you’ll find strategic keywords woven into the fabric of the content—not stuffed, but placed where they add value:

  • Google Search Console integration happens automatically when you authenticate your site.
  • GA4 user behavior analysis reveals where your audience drops off.
  • PageSpeed Insights optimization is no longer a separate task; it’s part of a unified report.
  • Core Web Vitals monitoring becomes contextual: a slow LCP on a lead gen page is more critical than on a blog post.
  • Technical SEO audit gets smarter because it cross-references recommendations with actual user behavior.

OpenAI API and Claude API Integration

The plugin intelligently routes your data to the best AI engine for the task. By default, it uses Anthropic’s Claude 3 Opus for its superior ability to handle long-context reasoning. However, you can switch to OpenAI’s GPT-4 Turbo with a single configuration change:

ai_config:
  engine: "openai-gpt-4-turbo"
  api_key_env_var: "OPENAI_API_KEY"  # Stored in .env file

Why this matters: Claude excels at synthesizing large datasets (ideal for weekly reports with thousands of rows), while GPT-4 is better for real-time, conversational insights. The plugin lets you choose the right tool for the right job.


The Philosophy Behind This Plugin

Before we dive into the technical details, let’s talk about why this plugin exists the way it does. Most SEO tools are built by engineers for engineers. They assume you already understand the relationship between Time to First Byte and Bounce Rate. But the truth is, most website owners, marketers, and content creators don’t think in metrics—they think in stories.

The GSC PAP Claude Plugin treats your website like a living organism. Google Search Console measures its heartbeat (clicks and impressions). GA4 tracks its behavior (sessions and conversions). PageSpeed Insights checks its reflexes (load times and responsiveness). Claude acts as the diagnostician who looks at all these vital signs and says, “Here’s what’s working, here’s what’s not, and here’s exactly what to do about it.”


Getting Started in Three Steps

Step 1: Clone and Configure

git clone https://github.com/your-repo/gsc-pap-claude-plugin.git
cd gsc-pap-claude-plugin
cp .env.example .env
# Add your Claude API key and OAuth credentials

Step 2: Install Dependencies

pip install -r requirements.txt

Step 3: Run Your First Analysis

python gsc_pap_claude.py --demo

Within 60 seconds, you’ll receive a sample report showing the kind of insights the plugin generates. Real data, real analysis, zero configuration.


License and Legal Notice

This project is released under the MIT License, which means you can use, modify, and distribute it freely—even in commercial products. No attribution required, though it’s always appreciated.

View the MIT License


Disclaimer

While this plugin provides powerful analytical capabilities, it should be used as a decision support tool, not as a replacement for professional SEO auditing. The AI-generated insights are based on available data and may not account for all business-specific factors. Always validate critical decisions with human expertise.

The plugin does not store your API keys or website data beyond the duration of the analysis session. All data processing occurs locally on your machine unless you explicitly enable cloud syncing.


Support the Project

If this plugin saves you time, helps you uncover hidden revenue opportunities, or simply makes your job easier, consider:

  • ⭐ Starring the repository on GitHub
  • 🐛 Reporting bugs or suggesting features via Issues
  • 💬 Joining our community Discord for real-time help

Download


Built for the 2026 web landscape, where speed, insight, and intelligence are no longer optional—they’re survival requirements.

Ver o original no GitHub

Bom para

Relacionados