AI-Map

AI-Map 是由 Oxylabs AI Studio 设计的一款网站地图搜索工具，旨在根据提示智能地探索并枚举网络上的相关页面。与传统的爬虫或站点地图不同，AI-Map 使用自然语言指令来引导地图搜索代理，并返回符合您请求的结构化 URL 列表。

借助 AI-Map，您可以无需编写复杂的爬取逻辑，即可快速映射整个网站或某个域名下的任意内容区域。

核心功能

• 灵活的域名或 URL 映射：可以从任意 URL 或域名根目录开始。
• 基于提示的指令：用自然语言描述您想要的页面类型。
• 可调参数：自定义来源数量、渲染方式和地理位置。
• 结构化输出：获取所有相关 URL 的结构化列表。

工作原理

要使用 AI-Map 开始映射目标网站，请按照以下步骤操作：

1. 输入您想要映射的 URL 或域名。
2. 用自然语言提示描述您的目标页面。
3. 配置映射参数，如来源限制、映射深度和地理位置。
4. 运行 AI 映射任务，从该域名中收集目标页面的 URL。

安装

首先，请确保您已获得 API 密钥（或通过 免费试用 获取 1000 个积分），并且已安装 Python 3.10 或更高版本。您可以使用 pip 安装 oxylabs-ai-studio 包：

pip install oxylabs-ai-studio

Python 示例代码

以下示例展示了如何使用 AI-Map 搜索代理执行一个简单的网站映射任务。

from oxylabs_ai_studio.apps.ai_map import AiMap
import json

# 初始化授权
ai_map = AiMap(api_key="<API_KEY>")

# 定义请求负载
payload = {
    "url": "https://career.oxylabs.io",
    "user_prompt": "招聘广告页面",
    "return_sources_limit": 10,
    "geo_location": None,
    "render_javascript": False,
}

# 开始映射
result = ai_map.map(**payload)

# 以 JSON 格式输出结果
print("URLs:")
print(json.dumps(result.data, indent=2))

更多关于 AI-Map 和 Oxylabs AI Studio Python SDK 的信息，请访问我们的 PyPI 仓库。对于 JavaScript 用户，您还可以查看我们的 AI Studio JavaScript SDK 指南。

请求参数

参数	描述	默认值
url*	映射的起始 URL 或域名	–
user_prompt*	用于查找页面的自然语言提示	–
output_format	返回的最大来源数量	25
render_javascript	启用 JavaScript 渲染以处理动态内容	False
geo_location	代理位置（ISO2 格式）	–

* – 必填参数

输出示例

AI-Map 搜索会返回易于集成到各种数据采集工作流中的结果。以下是之前请求的直接 JSON 输出示例：

URLs:
[
  "https://career.oxylabs.io/job/247ac098/head-of-marketing",
  "https://career.oxylabs.io/job/2d9ae321/product-owner",
  "https://career.oxylabs.io/job/496841ed/php-developer-golang",
  "https://career.oxylabs.io/job/736ef009/talent-sourcer",
  "https://career.oxylabs.io/job/7a4a4415/senior-python-engineer-webshare-product",
  "https://career.oxylabs.io/job/88f7340c/devops-squad-lead",
  "https://career.oxylabs.io/job/9946db47/junior-project-manager",
  "https://career.oxylabs.io/job/b2e1397e/account-executive-north-america",
  "https://career.oxylabs.io/job/d72db15b/senior-event-marketing-manager",
  "https://career.oxylabs.io/job/e1efecf0/seo-and-growth-marketing-lead"
]

实际应用场景

您可以以多种方式使用 AI-Map 搜索代理，包括：

• 在电商网站上映射产品类别。
• 列出公司域名下的所有博客文章。
• 记录 API 端点。
• 发现所有文档页面或帮助文章。
• 在招聘门户网站上查找职位发布。
• 以及更多其他用途……

常见问题解答

什么是网站映射？

网站映射是指发现并列出网站或域名内所有相关 URL 的过程。AI-Map 利用 AI 自动化这一流程，解读您的请求，智能地探索目标域名，并返回结构化的结果——例如所有博客文章、文档页面或产品类别。

AI-Map 与 AI-Crawler 有何不同？

AI-Map 的重点在于查找网站内的相关页面，而 AI-Crawler 则是从这些页面中提取结构化数据。简而言之，AI-Map 帮助您找到“在哪里”收集数据，而 AI-Crawler 则帮助您获取“数据本身”。

AI-Map 是否适用于任何网站？

AI-Map 搜索适用于大多数公开网站，包括那些使用 JavaScript 渲染的内容。然而，需要身份验证、设有付费墙或位于私有网络中的页面，默认情况下无法访问。

AI-Map 可以免费使用吗？

Oxylabs AI Studio 的 AI-Map 提供免费试用，注册后即可获得 1,000 个积分。试用期结束后，月度套餐 从每月 12 美元起，包含 3,000 个积分和每秒 1 次请求；更高级的套餐则提供更多积分和更高的请求速率。

了解更多信息

如需深入了解可用参数、高级集成及其他示例，请参阅 AI Studio 文档。

联系我们

如果您有任何疑问或需要支持，请发送邮件至 support@oxylabs.io，或通过 Oxylabs 控制台 上的在线聊天联系我们，亦可加入我们的 Discord 社区。企业客户请直接联系您的专属客户经理。

AI-Map-Py 快速上手指南

AI-Map 是由 Oxylabs AI Studio 推出的智能网站地图搜索代理。它利用自然语言指令，自动探索并枚举域名中符合特定需求的页面 URL，无需编写复杂的爬虫逻辑即可快速获取结构化链接列表。

环境准备

在开始之前，请确保满足以下要求：

• 操作系统：支持 Windows、macOS 或 Linux。
• Python 版本：需安装 Python 3.10 或更高版本。
• API Key：需要拥有 Oxylabs AI Studio 的 API Key。
  • 新用户可注册获取免费试用额度（1000 credits）：点击注册

安装步骤

使用 pip 安装官方 Python SDK 包 oxylabs-ai-studio。

pip install oxylabs-ai-studio

提示：如果在国内下载速度较慢，建议使用国内镜像源加速安装：

pip install oxylabs-ai-studio -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

以下是最简单的 Python 代码示例，演示如何初始化代理并执行一次网站映射任务，以查找特定的页面链接。

1. 将 <API_KEY> 替换为你实际的 API Key。
2. 修改 url 为目标域名。
3. 在 user_prompt 中用自然语言描述你想查找的页面类型（例如："job ad pages"）。

from oxylabs_ai_studio.apps.ai_map import AiMap
import json

# 初始化授权 (替换为你的 API Key)
ai_map = AiMap(api_key="<API_KEY>")

# 定义请求参数
payload = {
    "url": "https://career.oxylabs.io",       # 目标起始 URL 或域名
    "user_prompt": "job ad pages",            # 自然语言描述：想要查找的页面类型
    "return_sources_limit": 10,               # 返回结果的最大数量
    "geo_location": None,                     # 代理地理位置 (可选，ISO2 格式)
    "render_javascript": False,               # 是否启用 JS 渲染 (动态内容设为 True)
}

# 执行映射任务
result = ai_map.map(**payload)

# 输出结果为 JSON 格式
print("URLs:")
print(json.dumps(result.data, indent=2))

运行结果示例： 程序将输出一个包含匹配 URL 的 JSON 列表，例如所有招聘广告页面的链接，可直接用于后续的数据采集流程。