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 リンク監査
• ドキュメントのレビュー
• リンクの抽出と分析