This is a pre-crawl reconnaissance tool that hits XCrawl's Map API to discover URLs across a site before you commit to a full scrape. You give it an entry point, optional regex filters, and limits, and it returns a raw list of discovered links with credit costs. It's built around curl and node with local API key config, no Python required. Useful when you need to estimate scope, validate URL patterns, or cherry-pick sections of a large site instead of crawling blindly. The skill explicitly returns raw API responses by default, which is refreshing if you'd rather handle your own analysis than get an AI summary of what URLs look like.

skills.sh installs
217
GitHub stars
449
last updated
Aug 21, 2026

Install

$ npx -y skills add xcrawl-api/xcrawl-skills --skill xcrawl-map --agent claude-code

Installs into .claude/skills of the current project.

Files

XCrawl Map

Overview

This skill uses XCrawl Map API to discover URLs for a site. Default behavior is raw passthrough: return upstream API response bodies as-is.

Required Local Config

Before using this skill, the user must create a local config file and write XCRAWL_API_KEY into it.

Path: ~/.xcrawl/config.json

{
  "XCRAWL_API_KEY": "<your_api_key>"
}

Read API key from local config file only. Do not require global environment variables.

Credits and Account Setup

Using XCrawl APIs consumes credits. If the user does not have an account or available credits, guide them to register at https://dash.xcrawl.com/. After registration, they can activate the free 1000 credits plan before running requests.

Tool Permission Policy

Request runtime permissions for curl and node only. Do not request Python, shell helper scripts, or other runtime permissions.

API Surface

  • Start map task: POST /v1/map
  • Base URL: https://run.xcrawl.com
  • Required header: Authorization: Bearer <XCRAWL_API_KEY>

Usage Examples

cURL

Sponsors

Details

Repository
github.com/xcrawl-api/xcrawl-skills
Categories
Backend & APIs, Productivity & Planning, Marketing & SEO, Sales & Marketing
First seen
Jun 3, 2026

More from xcrawl-api/xcrawl-skills

All 5
1xcrawl-api avatarxcrawl-crawlxcrawl-api/xcrawl-skillsUse this skill for XCrawl crawl tasks, including bulk site crawling, crawler rule design, async status polling, and delivery of crawl output for downstream scra215skills.sh installs
2supabase avatare2e-studio-testssupabase/supabaseRun e2e tests in the Studio app. Use when asked to run e2e tests, run studio tests, playwright tests, or test the feature.211skills.sh installs
3firebase avatardeveloping-genkit-gofirebase/skillsdeveloping genkit go195skills.sh installs
4firebase avatarfirestore-security-rules-auditorfirebase/skillsfirestore security rules auditor123skills.sh installs
5payloadcms avatargenerate-translationspayloadcms/payloadWhen you add new translation keys to Payload's core packages or plugins, this skill walks you through the proper workflow: adding...0skills.sh installs
6proffesor-for-testing avatarquality-metricsproffesor-for-testing/sentinel-api-testingMeasure quality effectively with actionable metrics. Use when establishing quality dashboards, defining KPIs, or evaluating test effectiveness.0skills.sh installs