New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Keyword search request builder for XCrawl that controls location, language, and result limits and returns raw responses.

skills.sh installs
223
GitHub stars
450
last updated
Aug 21, 2026
View on GitHub

What it does

  • Covers search request design: a query plus optional location, language, and limit (1 to 100) sent to POST /v1/search
  • Reads the API key from ~/.xcrawl/config.json and sends it as a Bearer token, with curl and node as the only runtime tools
  • Returns the raw upstream response by default, including search_id, status, timestamps, and credit usage, with no summaries unless requested
  • Designed for workflows that need deterministic search calls and that avoid fabricating ranking guarantees or unsupported filters

Install

$ npx -y skills add xcrawl-api/xcrawl-skills --skill xcrawl-search -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

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

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

Similar to Xcrawl Search

More Backend & APIs