Link Switcher

GSC Integration (gsc-gui-tools)

1 min read

🔍 Overview

Link Switcher delegates Google Search Console automation to an external gsc-gui-tools service.

Instead of performing browser automation inside Link Switcher, the system:

  1. creates a request record in the database
  2. sends an HTTP request to gsc-gui-tools
  3. receives an async callback from gsc-gui-tools

Related models:

⚙️ Flow

1) Send appeal

  • Link Switcher creates a DomainAppealRequest and calls gsc-gui-tools.
  • A callback URL is provided: /api/v1/gsc/appeal-callback/?token=<token>.
  • The callback updates the request (finished_at, is_sent, screenshot_url, error_message, etc.).

2) Safety check

  • Link Switcher creates a DomainSafetyRequest and calls gsc-gui-tools.
  • A callback URL is provided: /api/v1/gsc/safety-check-callback/?token=<token>.
  • The callback updates the request (finished_at, is_safe, screenshot_url, error_message, etc.).
  • After callback, Link Switcher can trigger tracking-domain blocking/switching if the domain is not safe.

🛠️ Configuration

The integration uses the following settings:

GSC_GUI_TOOLS_BASE_URL = "https://<gsc-gui-tools-host>"
GSC_AUTHORIZATION_TOKEN = "<bearer token>"
GSC_CALLBACK_BASE_URL = "https://<link-switcher-host>"

🔗 Related docs

Graph View

Backlinks