
Xcrawl Search
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
What it does
- Covers search request design: a query plus optional
location,language, andlimit(1 to 100) sent toPOST /v1/search - Reads the API key from
~/.xcrawl/config.jsonand sends it as a Bearer token, withcurlandnodeas 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 -yInstalls 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 5Similar to Xcrawl Search
More Backend & APIs
xcrawl-crawlxcrawl-api/xcrawl-skills216 installsUse this skill for XCrawl crawl tasks, including bulk site crawling, crawler rule design, async status polling, and delivery of crawl output for downstream scra
e2e-studio-testssupabase/supabase211 installsRun e2e tests in the Studio app. Use when asked to run e2e tests, run studio tests, playwright tests, or test the feature.
firestore-security-rules-auditorfirebase/skills123 installsfirestore security rules auditor
test-with-spannernkeonye-akumah/decentralized-storage-gatewayRun unit tests that require the Spanner emulator. Use this skill when the user wants to run tests in packages like satellite/metabase, satellite/metainfo, or an
generate-translationspayloadcms/payloadWhen you add new translation keys to Payload's core packages or plugins, this skill walks you through the proper workflow: adding...
triage-ci-flakepayloadcms/payloadThis walks you through reproducing flaky CI failures locally before you touch any code, which is the right approach even if it feels...