This is your interface to XCrawl's full-site crawling API. You get async crawl orchestration with depth limits, regex path filtering, and multi-format output (markdown, links, JSON extraction via prompt or schema). It reads your API key from a local config file at ~/.xcrawl/config.json and uses only curl and node for execution, no Python dependencies. The skill returns raw API responses by default, so you handle the data structure yourself. Useful when you need to map an entire documentation site or product catalog before scraping specific pages. XCrawl runs on a credit system with 1000 free credits to start. The workflow is standard: POST to create a crawl job, poll GET until status hits completed, then parse the data array.

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

Install

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

Installs into .claude/skills of the current project.

Files

XCrawl Crawl

Overview

This skill orchestrates full-site or scoped crawling with XCrawl Crawl APIs. 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 crawl: POST /v1/crawl
  • Read result: GET /v1/crawl/{crawl_id}
  • Base URL: https://run.xcrawl.com
  • Required header: Authorization: Bearer <XCRAWL_API_KEY>

Usage Examples

cURL (create + result)

Sponsors

Details

Repository
github.com/xcrawl-api/xcrawl-skills
Categories
Backend & APIs, Marketing & SEO, Design & UI/UX
First seen
Jun 3, 2026

More from xcrawl-api/xcrawl-skills

All 5
1supabase 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
2firebase avatardeveloping-genkit-gofirebase/skillsdeveloping genkit go195skills.sh installs
3firebase avatarfirestore-security-rules-auditorfirebase/skillsfirestore security rules auditor123skills.sh installs
4payloadcms 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
5proffesor-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
6xixu-me avatarsecure-linux-web-hostingxixu-me/skillsUse when setting up, hardening, or reviewing a cloud server for self-hosting, including DNS, SSH, firewalls, Nginx, static-site hosting, reverse-proxying an app520.6Kskills.sh installs