SuperAPI AI 工具集

url-analysis

通用与其它

查看项目

更新于 10-15 07:55

技能介绍

用途

URL Analysis 是一个 URL 校验与上下文分析技能,用于确保链接在技术上可用、在语境上恰当。它同时从技术层面和上下文层面分析 URL,适用于校验内容中的链接、分析链接语境与适当性、从文档中提取链接、检查链接可用性、确保链接相关性以及审计链接质量。

主要能力

技术校验:检查 HTTP 状态码(200、301、404 等)、重定向链、响应时间、SSL 证书有效性以及 URL 语法有效性。

上下文分析:评估链接文本与目标内容是否一致、语义对齐程度、发布日期相关性、来源权威性以及对读者的价值。

链接提取:提取并分类链接,包括内部链接与外部链接、锚点链接、文件下载和 API 端点。

内容相关性:检查被链接内容是否与上下文匹配。

安全分析:识别安全隐患。

质量评估:提供链接质量评分。

使用方式

该技能包含位于 scripts/ 目录下的 Python 辅助脚本 validate_urls.py,用于从文件或命令行校验 URL,检查 HTTP 状态码、重定向和可访问性,并输出包含校验结果的 JSON。

从文件校验 URL:

python scripts/validate_urls.py document.md

校验单个 URL:

python scripts/validate_urls.py --url https://example.com

在对话中可直接提出需求,例如:校验本文档中的所有 URL;检查这些链接是否适合其上下文;提取并分析此内容中的所有链接。

分析流程

技术校验:使用辅助脚本检查 HTTP 状态码、重定向链、响应时间、SSL 证书有效性和 URL 语法有效性。

上下文分析:评估链接文本与目标内容、语义对齐、发布日期相关性、来源权威性和对读者的价值。

链接提取:将链接分类为内部链接与外部链接、锚点链接、文件下载和 API 端点。

示例

示例 1:URL 校验。输入为“校验博客文章中的 URL”,输出包含技术校验与上下文分析两部分。技术校验逐条列出 URL 的状态、响应时间、SSL 和重定向情况,例如:状态 200 OK、响应时间 320ms、SSL 有效、无重定向;状态 301 跳转至新地址并提示应更新链接;状态 404 未找到并提示移除或寻找替代。上下文分析评估链接文本与目标内容的相关性,例如链接文本“Learn more about React”指向 React 文档时相关性高、状态恰当;链接文本“Advanced React patterns”指向首页而非具体文章时相关性低,问题为链接文本与目标不匹配,建议链接到具体文章或更新链接文本。

最佳实践

URL 校验:检查状态,确认所有链接返回 200 或适当的重定向;更新重定向,使用最终目标地址而非重定向链;上下文很重要,确保链接与其上下文匹配;安全方面优先使用 HTTPS 并检查 SSL 有效性;相关性方面验证被链接内容符合预期。

适用场景

链接校验、内容质量保证、SEO 链接审计、文档审查、链接提取与分析。

限制

资料未提供该技能的具体运行环境要求、依赖安装方式、支持的 URL 协议范围、速率限制或并发能力等信息,暂未提供。