# oxylabs/ai-map-py

AI Map is an AI-powered website mapping tool by Oxylabs AI Studio that uses natural language prompts to intelligently discover and extract relevant URLs from any website.

Repository: https://github.com/oxylabs/ai-map-py
Canonical: https://ross.abutalabs.com/products/ai-map-py
Homepage: https://aistudio.oxylabs.io/apps/map?utm_source=877&utm_medium=affiliate&utm_campaign=ai_studio&utm_content=ai-map&groupid=877&transaction_id=102f49063ab94276ae8f116d224b67
License Family: other
Topics: ai-map, ai-studio, web-scraping, map-scraper, site-mapping, map-search
Last push: 2026-04-02T09:43:21+00:00

## Health v2 (maintenance only)
Score: 50/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 75, release rhythm 35, longevity 22
- inputs: {"age_days": 308, "days_push": 153, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1537, forks 0 (observed 2026-08-28T04:05:00.108649+00:00)

## What it is
AI-Map is a Python SDK client for Oxylabs AI Studio's AI-powered website mapping service, which discovers and extracts relevant URLs from any domain using natural language prompts. It replaces traditional crawlers and sitemap parsing with an agent that returns structured lists of matching URLs.

## Use cases
- map all job ad pages on a careers site
- discover product URLs from an e-commerce domain
- find blog article links matching a topic prompt
- enumerate relevant pages without writing crawl logic
- deep-crawl a website up to 10,000 URLs
- filter site URLs by natural language description

## When to choose
- you need targeted URL discovery from a domain using plain-language prompts
- you want structured URL lists without building custom crawlers
- you already use Oxylabs AI Studio and want Python integration

## When to avoid
- you need a fully free, self-hosted crawler with no API costs
- you only need a standard sitemap.xml parse
- you cannot rely on a third-party paid API service

## Facets
- artifact type: library
- maturity: active
- function: web-scraping, search-engine, sdk, nlp
- domain: crawlers, web-development, developer-tools
- platform: python, cli
- tags: ai-map, site-mapping, url-discovery, oxylabs, ai-studio, prompt-based-crawling, api-client, data-engineering, web-server

## Member repositories
- oxylabs/ai-map-py (main) score 50

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:00.108649+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:01.607331+00:00, confidence not recorded.
  - readme: https://github.com/oxylabs/ai-map-py (fetched 2026-08-28T04:05:00.108649+00:00, sha d75e8fd5d137)
  - homepage: https://aistudio.oxylabs.io/apps/map?utm_source=877&utm_medium=affiliate&utm_campaign=ai_studio&utm_content=ai-map&groupid=877&transaction_id=102f49063ab94276ae8f116d224b67 (fetched 2026-08-29T11:33:10.074687+00:00, sha a2391e039add)
  - site_page: https://aistudio.oxylabs.io/pricing (fetched 2026-08-29T11:33:10.084001+00:00, sha 9226846bdd8d)
  - site_page: https://aistudio.oxylabs.io/releases (fetched 2026-08-29T11:33:10.086367+00:00, sha 2807647bbec5)
- Data as of 2026-08-30T08:39:29.467469+00:00.