gcrawl-sdk

Official Python SDK for GCrawl — Scrape, crawl, screenshot, fetch links, and search web pages with ease.

Installation

pip install gcrawl-sdk

Quick Start

from gcrawl_sdk import GcrawlClient, ScrapeOptions

client = GcrawlClient(api_key="your-api-key")

# Scrape a website (synchronous polling)
result = client.scrape(
    url="https://gramosoft.tech",
    options=ScrapeOptions(markdown_enabled=True, screenshot_enabled=True),
    wait=True
)
print("Scraped Markdown:", result.markdown)
print("Screenshot URL:", result.screenshot_url)

# Search web synchronously
search_res = client.search("gramosoft", limit=5, geo="IN")
for res in search_res.results:
    print(res.position, res.title, res.url)

API Key

Set your API key as an environment variable:

export GCRAWL_API_KEY="your-api-key"

Or pass it directly to the client:

client = GcrawlClient(api_key="your-api-key")