url-analysis

URL 分析

此技能会从技术和上下文两方面验证 URL，确保链接可用且适合其上下文。

何时使用此技能

• 验证内容中的 URL 时
• 分析链接的上下文和适用性时
• 从文档中提取链接时
• 检查链接是否可用时
• 确保链接的相关性时
• 审核链接质量时

此技能的功能

1. 技术验证：检查 HTTP 状态、重定向和 SSL
2. 上下文分析：评估链接是否合适
3. 链接提取：提取链接并进行分类
4. 内容相关性：检查链接内容是否符合上下文
5. 安全分析：识别安全问题
6. 质量评估：提供链接质量评分

辅助脚本

此技能在 scripts/ 中包含 Python 辅助脚本：

• validate_urls.py：验证文件或命令行中的 URL。检查 HTTP 状态码、重定向和可访问性。输出包含验证结果的 JSON。

  # Validate URLs from file
  python scripts/validate_urls.py document.md
  
  # Validate single URL
  python scripts/validate_urls.py --url https://example.com
  

使用方法

验证 URL

Validate all URLs in this document

Check if these links are appropriate for their context

特定分析

Extract and analyze all links in this content

分析流程

技术验证

使用辅助脚本：

此技能包含一个用于 URL 验证的 Python 辅助脚本：

# Validate URLs from a file
python scripts/validate_urls.py document.md

# Validate a single URL
python scripts/validate_urls.py --url https://example.com

检查项：

• HTTP 状态码（200、301、404 等）
• 重定向链
• 响应时间
• SSL 证书有效性
• URL 语法有效性

上下文分析

评估项：

• 链接文本与目标内容是否一致
• 语义是否匹配
• 发布日期的相关性
• 来源的权威性
• 对读者的价值

链接提取

分类：

• 内部链接与外部链接
• 锚点链接
• 文件下载
• API 端点

示例

示例 1：URL 验证

输入：验证博客文章中的 URL

输出：

## URL Analysis: Blog Post

### Technical Validation

**1. https://example.com/article**
- **Status**: 200 OK
- **Response Time**: 320ms
- **SSL**: Valid
- **Redirects**: None

**2. https://old-site.com/page**
- **Status**: 301 → https://new-site.com/page
- **Issue**: Redirect chain (should update link)
- **Fix**: Update to final destination

**3. https://broken-link.com**
- **Status**: 404 Not Found
- **Issue**: Broken link
- **Fix**: Remove or find alternative

### Contextual Analysis

**4. https://example.com/article**
- **Link Text**: "Learn more about React"
- **Destination**: React documentation
- **Relevance**: High ✓
- **Status**: Appropriate

**5. https://example.com/homepage**
- **Link Text**: "Advanced React patterns"
- **Destination**: Homepage (not specific article)
- **Relevance**: Low ✗
- **Issue**: Link text doesn't match destination
- **Fix**: Link to specific article or update link text

最佳实践

URL 验证

1. 检查状态：确认所有链接均返回 200 或适当的重定向
2. 更新重定向：使用最终目标地址，而非重定向链
3. 关注上下文：确保链接符合其上下文
4. 安全性：优先使用 HTTPS，并检查 SSL 有效性
5. 相关性：确认链接内容符合预期

相关用例

• 链接验证
• 内容质量保证
• SEO 链接审核
• 文档审查
• 链接提取与分析