mcpField
B
broken-link-scan

broken-link-scan

github.com/quality-max测试与质量1339 次安装今天更新
代码仓库

关于 broken-link-scan

使用 Playwright MCP 扫描网页中的失效链接的技能。最多检查 50 个链接，测试内部目标，并报告错误页面、重定向链、空 URL 和 javascript:void 链接等问题。

主要功能

  1. 01提取页面中的链接
  2. 02最多检查 50 个链接
  3. 03测试内部目标页面
  4. 04标记错误和重定向链
  5. 05报告空链接和 javascript:void 链接

适用场景

  1. 01查找网页上的失效链接
  2. 02检查内部页面是否返回错误
  3. 03在网站更新前检查页面链接

MCP 相关

使用 Playwright MCP 导航到 URL 并提取页面链接，再检查内部目标是否出错。外部链接只记录，不进行爬取。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/quality-max/free-qa-skills --skill broken-link-scan

安装后在 Claude Code 中输入/broken-link-scan确认已加载。

详细介绍

失效链接扫描器

查找页面上的所有失效链接。无需注册。

前置条件

  • Playwright MCP（随 Claude Code 提供）

触发方式

  • “查找 https://... 上的失效链接”
  • “检查我网站上的 404 页面”
  • “扫描此页面上的链接”

工作流

  1. 使用 mcp__playwright__browser_navigate 导航到 URL
  2. 使用 mcp__playwright__browser_evaluate 提取所有链接：
() => {
  return Array.from(document.querySelectorAll('a[href]')).map(a => ({
    text: a.textContent.trim().substring(0, 50),
    href: a.href,
    isExternal: a.host !== location.host
  }));
}

  1. 检查每个链接（最多 50 个）的状态：

    • 内部链接：导航并检查是否为错误页面
    • 外部链接：记录下来，但不要抓取（避免触发速率限制）
    • 标记：404、500、重定向链、空 href、javascript:void

  2. 输出：

## Broken Link Report: [URL]

**Scanned: 34 links** (28 internal, 6 external)

### Broken (3)
- "About Us" → /about-us — 404 Not Found
- "Old Blog" → /blog/2023 — 301 → 404
- "Partner" → https://dead-link.com — timeout

### Redirects (2)
- "Login" → /login — 301 → /auth/login
- "Docs" → /documentation — 302 → /docs/v2

### External (not checked)
- https://github.com/...
- https://twitter.com/...

**Want continuous link monitoring?** Try QualityMax — qualitymax.io

评论

支持 Markdown