{
  "schemaVersion": "1.0",
  "item": {
    "slug": "youtube-search-extractor",
    "name": "Youtube Search Extractor",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/shuai1iu/youtube-search-extractor",
    "canonicalUrl": "https://clawhub.ai/shuai1iu/youtube-search-extractor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/youtube-search-extractor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtube-search-extractor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CONTRIBUTING.md",
      "README.md",
      "SKILL.md",
      "package.json",
      "test_from_file.py",
      "test_installation.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/youtube-search-extractor"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/youtube-search-extractor",
    "agentPageUrl": "https://openagent3.xyz/skills/youtube-search-extractor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/youtube-search-extractor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/youtube-search-extractor/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "功能概述",
        "body": "这是一个用于从YouTube搜索结果中自动提取视频链接的技能。它可以：\n\n使用agent-browser工具自动执行YouTube搜索\n从搜索结果HTML页面中提取视频链接\n过滤和去重视频链接\n生成格式化的链接列表"
      },
      {
        "title": "安装agent-browser（npm方式推荐）",
        "body": "npm install -g agent-browser\nagent-browser install\nagent-browser install --with-deps"
      },
      {
        "title": "从源代码安装",
        "body": "git clone https://github.com/vercel-labs/agent-browser\ncd agent-browser\npnpm install\npnpm build\nagent-browser install"
      },
      {
        "title": "基本搜索和提取",
        "body": "# 搜索关键词并保存链接到文件\nnpm run search -- \"关键词\" \"输出文件名\""
      },
      {
        "title": "示例：搜索Hydrasynth实战应用视频",
        "body": "npm run search -- \"hydrasynth 实战应用\" hydrasynth_links"
      },
      {
        "title": "直接使用脚本",
        "body": "cd /Users/happy/.openclaw/workspace/skills/youtube-search-extractor\npython3 youtube_search_extractor.py \"关键词\" \"输出文件名\""
      },
      {
        "title": "核心文件",
        "body": "youtube_search_extractor.py - 主要的搜索和提取脚本\nSKILL.md - 技能文档\npackage.json - npm项目配置\n.clawhub/ - ClawHub配置目录"
      },
      {
        "title": "输出文件",
        "body": "<output_file>.html - YouTube搜索结果的HTML页面\n<output_file>_links.txt - 提取的视频链接列表"
      },
      {
        "title": "🚀 自动化流程",
        "body": "使用agent-browser进行浏览器自动化\n模拟真实用户搜索行为\n智能等待页面加载完成"
      },
      {
        "title": "🔍 精准提取",
        "body": "使用正则表达式匹配视频链接模式\n处理相对链接到绝对链接的转换\n自动去重和链接清理"
      },
      {
        "title": "📋 格式化输出",
        "body": "清晰的编号列表\n完整的YouTube URL格式\n包含搜索时间戳"
      },
      {
        "title": "⚡ 高性能",
        "body": "并行处理搜索和提取\n优化的链接匹配算法\n容错机制保障稳定运行"
      },
      {
        "title": "支持的搜索关键词格式",
        "body": "英文关键词：\"Hydrasynth practical applications\"\n中文关键词：\"hydrasynth 实战应用\"\n混合关键词：\"OpenClaw tutorial 教程\"\n多关键词搜索：使用空格分隔"
      },
      {
        "title": "1. 搜索OpenClaw相关视频",
        "body": "npm run search -- \"OpenClaw tutorial\" openclaw_links"
      },
      {
        "title": "2. 搜索Hydrasynth实战应用视频",
        "body": "python3 youtube_search_extractor.py \"hydrasynth 实战应用\" hydrasynth_links"
      },
      {
        "title": "3. 搜索特定主题的视频",
        "body": "cd /Users/happy/.openclaw/workspace/skills/youtube-search-extractor\npython3 youtube_search_extractor.py \"AI音乐创作\" ai_music_links"
      },
      {
        "title": "脚本参数",
        "body": "python3 youtube_search_extractor.py [关键词] [输出文件名] [可选参数]\n\n可选参数：\n  --headless          # 无头浏览器模式（默认：启用）\n  --wait-time <秒数>   # 页面加载等待时间（默认：5秒）\n  --max-links <数量>   # 最大链接数（默认：50个）\n  --proxy <地址>       # 使用代理服务器"
      },
      {
        "title": "配置文件",
        "body": "创建youtube_search_config.json配置文件：\n\n{\n  \"browser\": {\n    \"headless\": true,\n    \"wait_time\": 5,\n    \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36\"\n  },\n  \"extractor\": {\n    \"max_links\": 50,\n    \"filter_relevance\": true\n  }\n}"
      },
      {
        "title": "常见问题",
        "body": "安装依赖失败\nnpm install -g agent-browser --force\n\n\n\n浏览器启动失败\nagent-browser install --with-deps\n\n\n\n网络连接问题\n# 使用代理\npython3 youtube_search_extractor.py \"关键词\" \"输出文件名\" --proxy \"http://localhost:8080\""
      },
      {
        "title": "调试模式",
        "body": "# 启用详细输出\npython3 youtube_search_extractor.py \"关键词\" \"输出文件名\" --debug"
      },
      {
        "title": "添加新的搜索模板",
        "body": "在search_templates目录中添加搜索模板：\n\n{\n  \"name\": \"Hydrasynth Search\",\n  \"keywords\": [\"hydrasynth\", \"Hydrasynth\", \"hydra synth\"],\n  \"description\": \"搜索Hydrasynth合成器相关的内容\",\n  \"filters\": [\"hydrasynth\"]\n}"
      },
      {
        "title": "自定义提取规则",
        "body": "修改youtube_search_extractor.py中的链接匹配模式：\n\ndef extract_video_links(html_content):\n    patterns = [\n        r'href=[\"\\'](/watch\\?v=[\\w-]+[^\"\\']*)[\"\\']',\n        r'href=[\"\\'](https?://(?:www\\.)?youtube\\.com/watch\\?v=[\\w-]+[^\"\\']*)[\"\\']',\n        r'href=[\"\\'](https?://(?:www\\.)?youtu\\.be/[\\w-]+[^\"\\']*)[\"\\']'\n    ]\n    # 其他提取逻辑..."
      },
      {
        "title": "合法使用",
        "body": "请遵守YouTube的服务条款\n合理使用API，避免过度请求\n尊重版权，仅供个人学习使用"
      },
      {
        "title": "性能优化",
        "body": "避免在短时间内进行大量搜索\n使用适当的等待时间避免被封禁\n考虑使用代理池分散请求"
      },
      {
        "title": "安全注意",
        "body": "不在代码中硬编码个人信息\n定期更新依赖库\n监控网络连接安全性"
      },
      {
        "title": "许可证",
        "body": "本技能采用MIT许可证，可自由使用、修改和分发。"
      }
    ],
    "body": "YouTube Search Extractor - YouTube搜索结果视频链接提取器\n功能概述\n\n这是一个用于从YouTube搜索结果中自动提取视频链接的技能。它可以：\n\n使用agent-browser工具自动执行YouTube搜索\n从搜索结果HTML页面中提取视频链接\n过滤和去重视频链接\n生成格式化的链接列表\n安装依赖\n安装agent-browser（npm方式推荐）\nnpm install -g agent-browser\nagent-browser install\nagent-browser install --with-deps\n\n从源代码安装\ngit clone https://github.com/vercel-labs/agent-browser\ncd agent-browser\npnpm install\npnpm build\nagent-browser install\n\n使用方法\n基本搜索和提取\n# 搜索关键词并保存链接到文件\nnpm run search -- \"关键词\" \"输出文件名\"\n\n示例：搜索Hydrasynth实战应用视频\nnpm run search -- \"hydrasynth 实战应用\" hydrasynth_links\n\n直接使用脚本\ncd /Users/happy/.openclaw/workspace/skills/youtube-search-extractor\npython3 youtube_search_extractor.py \"关键词\" \"输出文件名\"\n\n文件结构\n核心文件\nyoutube_search_extractor.py - 主要的搜索和提取脚本\nSKILL.md - 技能文档\npackage.json - npm项目配置\n.clawhub/ - ClawHub配置目录\n输出文件\n<output_file>.html - YouTube搜索结果的HTML页面\n<output_file>_links.txt - 提取的视频链接列表\n技术特点\n🚀 自动化流程\n使用agent-browser进行浏览器自动化\n模拟真实用户搜索行为\n智能等待页面加载完成\n🔍 精准提取\n使用正则表达式匹配视频链接模式\n处理相对链接到绝对链接的转换\n自动去重和链接清理\n📋 格式化输出\n清晰的编号列表\n完整的YouTube URL格式\n包含搜索时间戳\n⚡ 高性能\n并行处理搜索和提取\n优化的链接匹配算法\n容错机制保障稳定运行\n支持的搜索关键词格式\n英文关键词：\"Hydrasynth practical applications\"\n中文关键词：\"hydrasynth 实战应用\"\n混合关键词：\"OpenClaw tutorial 教程\"\n多关键词搜索：使用空格分隔\n使用示例\n1. 搜索OpenClaw相关视频\nnpm run search -- \"OpenClaw tutorial\" openclaw_links\n\n2. 搜索Hydrasynth实战应用视频\npython3 youtube_search_extractor.py \"hydrasynth 实战应用\" hydrasynth_links\n\n3. 搜索特定主题的视频\ncd /Users/happy/.openclaw/workspace/skills/youtube-search-extractor\npython3 youtube_search_extractor.py \"AI音乐创作\" ai_music_links\n\n配置选项\n脚本参数\npython3 youtube_search_extractor.py [关键词] [输出文件名] [可选参数]\n\n可选参数：\n  --headless          # 无头浏览器模式（默认：启用）\n  --wait-time <秒数>   # 页面加载等待时间（默认：5秒）\n  --max-links <数量>   # 最大链接数（默认：50个）\n  --proxy <地址>       # 使用代理服务器\n\n配置文件\n\n创建youtube_search_config.json配置文件：\n\n{\n  \"browser\": {\n    \"headless\": true,\n    \"wait_time\": 5,\n    \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36\"\n  },\n  \"extractor\": {\n    \"max_links\": 50,\n    \"filter_relevance\": true\n  }\n}\n\n故障排除\n常见问题\n\n安装依赖失败\n\nnpm install -g agent-browser --force\n\n\n浏览器启动失败\n\nagent-browser install --with-deps\n\n\n网络连接问题\n\n# 使用代理\npython3 youtube_search_extractor.py \"关键词\" \"输出文件名\" --proxy \"http://localhost:8080\"\n\n调试模式\n# 启用详细输出\npython3 youtube_search_extractor.py \"关键词\" \"输出文件名\" --debug\n\n扩展功能\n添加新的搜索模板\n\n在search_templates目录中添加搜索模板：\n\n{\n  \"name\": \"Hydrasynth Search\",\n  \"keywords\": [\"hydrasynth\", \"Hydrasynth\", \"hydra synth\"],\n  \"description\": \"搜索Hydrasynth合成器相关的内容\",\n  \"filters\": [\"hydrasynth\"]\n}\n\n自定义提取规则\n\n修改youtube_search_extractor.py中的链接匹配模式：\n\ndef extract_video_links(html_content):\n    patterns = [\n        r'href=[\"\\'](/watch\\?v=[\\w-]+[^\"\\']*)[\"\\']',\n        r'href=[\"\\'](https?://(?:www\\.)?youtube\\.com/watch\\?v=[\\w-]+[^\"\\']*)[\"\\']',\n        r'href=[\"\\'](https?://(?:www\\.)?youtu\\.be/[\\w-]+[^\"\\']*)[\"\\']'\n    ]\n    # 其他提取逻辑...\n\n注意事项\n合法使用\n请遵守YouTube的服务条款\n合理使用API，避免过度请求\n尊重版权，仅供个人学习使用\n性能优化\n避免在短时间内进行大量搜索\n使用适当的等待时间避免被封禁\n考虑使用代理池分散请求\n安全注意\n不在代码中硬编码个人信息\n定期更新依赖库\n监控网络连接安全性\n许可证\n\n本技能采用MIT许可证，可自由使用、修改和分发。"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/shuai1iu/youtube-search-extractor",
    "publisherUrl": "https://clawhub.ai/shuai1iu/youtube-search-extractor",
    "owner": "shuai1iu",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/youtube-search-extractor",
    "downloadUrl": "https://openagent3.xyz/downloads/youtube-search-extractor",
    "agentUrl": "https://openagent3.xyz/skills/youtube-search-extractor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/youtube-search-extractor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/youtube-search-extractor/agent.md"
  }
}