# backlink-guard

backlink-guard vets target link directories before submission, flags manipulative backlink patterns, and discovers broken redirects.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 77 repo stars
- Author: zhuyansen
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zhuyansen/backlink-guard
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/backlink-guard

## What it does

The tool inspects prospective link sources to prevent search engine penalties. In its zero-key mode, it examines target sites directly to catch parked domains, mandatory reciprocal badge demands, and commercial link setups. Supplying API keys for GoAnyAPI, Glasser, or AIsa unlocks visitor estimates, ratings, Google index statuses, and composite spam scores.

Every audited site receives a concrete recommendation such as skip, free only, look first, or submit, along with underlying evidence. It also tracks shared analytics IDs, ad account tags, and page markup signatures to uncover private blog networks run by a single operator.

Running via `uvx` requires Python 3.10+. Paid external checks are bypassed completely when a site's own HTML already marks it as parked or dead.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `GLASSER_API_KEY`, `AISA_API_KEY`, `GOANYAPI_API_KEY`, `BACKLINK_GUARD_STATE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GLASSER_API_KEY=<GLASSER_API_KEY> --env AISA_API_KEY=<AISA_API_KEY> --env GOANYAPI_API_KEY=<GOANYAPI_API_KEY> --env BACKLINK_GUARD_STATE=<BACKLINK_GUARD_STATE> --transport stdio backlink-guard -- uvx backlink-guard
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from backlink-guard <command>

### Codex

**Platform CLI**
```bash
codex mcp add backlink-guard --env GLASSER_API_KEY=<GLASSER_API_KEY> --env AISA_API_KEY=<AISA_API_KEY> --env GOANYAPI_API_KEY=<GOANYAPI_API_KEY> --env BACKLINK_GUARD_STATE=<BACKLINK_GUARD_STATE> -- uvx backlink-guard
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from backlink-guard <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "backlink-guard": {
            "command": "uvx",
            "args": [
                "backlink-guard"
            ],
            "env": {
                "GLASSER_API_KEY": "<GLASSER_API_KEY>",
                "AISA_API_KEY": "<AISA_API_KEY>",
                "GOANYAPI_API_KEY": "<GOANYAPI_API_KEY>",
                "BACKLINK_GUARD_STATE": "<BACKLINK_GUARD_STATE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from backlink-guard <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "backlink-guard": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "backlink-guard"
            ],
            "env": {
                "GLASSER_API_KEY": "<GLASSER_API_KEY>",
                "AISA_API_KEY": "<AISA_API_KEY>",
                "GOANYAPI_API_KEY": "<GOANYAPI_API_KEY>",
                "BACKLINK_GUARD_STATE": "<BACKLINK_GUARD_STATE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from backlink-guard <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GLASSER_API_KEY=<GLASSER_API_KEY> -e AISA_API_KEY=<AISA_API_KEY> -e GOANYAPI_API_KEY=<GOANYAPI_API_KEY> -e BACKLINK_GUARD_STATE=<BACKLINK_GUARD_STATE> backlink-guard uvx backlink-guard
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from backlink-guard <command>

## When to use it
- screen external websites for search engine link spam compliance
- detect shared ownership across sites using identical page templates or tracking IDs
- spot incoming backlinks landing on 404 errors to map out 301 redirects
- filter out link farms demanding mandatory link exchanges before submitting

## Example prompts
- Vet mcpservers.org and producthunt.com using backlink-guard before submitting
- Audit backlink targets and show which ones require reciprocal badges
- Check lost backlinks pointing to missing routes and suggest 301 redirects

## Similar
- [backlink-analysis](https://affpapa.org/en/nevibecode/skills/backlink-analysis.md) — skill · 1200 installs
- [backlink-audit](https://affpapa.org/en/nevibecode/skills/backlink-audit.md) — skill · 450 installs
- [link-building](https://affpapa.org/en/nevibecode/skills/link-building.md) — skill · 14000 installs
- [link-prospecting](https://affpapa.org/en/nevibecode/skills/link-prospecting.md) — skill · 7400 installs
- [build-links](https://affpapa.org/en/nevibecode/skills/build-links.md) — skill · 6500 installs
- [backlink](https://affpapa.org/en/nevibecode/skills/backlink.md) — skill · ★ 313 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
