This wraps XCrawl's search API so you can run keyword queries with location and language controls directly from Claude. It reads your API key from a local config file at ~/.xcrawl/config.json, hits the search endpoint with curl or node, and returns raw JSON results without summarizing unless you ask. You get 1000 free credits to start. The skill is pretty straightforward: you pass a query, optional location and language parameters, and a result limit, then decide what to crawl next based on what comes back. It's a passthrough tool, not an agent that interprets results for you.

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

Install

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

Installs into .claude/skills of the current project.

Files

XCrawl Search

Overview

This skill uses XCrawl Search API to retrieve query-based results. 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

  • Search endpoint: POST /v1/search
  • 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, Design & UI/UX
First seen
Jun 3, 2026

More from xcrawl-api/xcrawl-skills

All 5
1futuregerald avataradonisjs-best-practicesfuturegerald/futuregerald-claude-pluginUse when building AdonisJS v6 applications, implementing features in AdonisJS, or reviewing AdonisJS code. Covers routing, controllers, validation, authenticati216skills.sh installs
2davila7 avatartwilio-communicationsdavila7/claude-code-templatesBuild communication features with Twilio: SMS messaging, voice calls, WhatsApp Business API, and user verification (2FA). Covers the full spectrum from simple n213skills.sh installs
3davila7 avatarhubspot-integrationdavila7/claude-code-templatesExpert patterns for HubSpot CRM integration including OAuth authentication, CRM objects, associations, batch operations, webhooks, and custom objects. Covers No212skills.sh installs
4get-convex avatarfunction-creatorget-convex/convex-agent-pluginsCreate Convex queries, mutations, and actions with proper validation, authentication, and error handling. Use when implementing new API endpoints.209skills.sh installs
5itechmeat avatarrefine-devitechmeat/llm-codeRefine.dev headless React framework for CRUD apps: data providers, resources, routing, authentication, hooks, and forms. Use when building admin panels, dashboa208skills.sh installs
6sendaifun avatarsolana-kit-migrationsendaifun/skillsHelps developers understand when to use @solana/kit vs @solana/web3.js (v1), provides migration guidance, API mappings, and handles edge cases for Solana JavaSc208skills.sh installs