Metadata-Version: 2.4
Name: arachne-sdk
Version: 0.2.0
Summary: Python SDK for Arachne — Web Intelligence Platform: search, scrape, browser, vision, transcribe, RAG, and more
Author-email: Samuel Medeiros <samuel@arachne.seu.pet>
License-Expression: MIT
Project-URL: Homepage, https://arachne.seu.pet
Project-URL: Source, https://github.com/samuelmedeiros/arachne
Project-URL: Documentation, https://docs.arachne.seu.pet
Keywords: scraping,web-intelligence,crawler,rag,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27

# Arachne Python SDK

**Web Intelligence Platform** — search, scrape, browser automation, vision, transcribe, RAG queries, and more.

## Quick Start

```bash
pip install arachne-sdk
```

```python
from arachne_sdk import Arachne

client = Arachne(api_key="arn_...")

# Web search
results = client.search("preço iPhone 16 Brasil 2026")
for r in results:
    print(f"{r.title}: {r.url}")

# Scrape a URL
content = client.scrape("https://example.com")
print(content.markdown[:500])

# Smart Router — let Arachne figure out the best tool
result = client.do("busca e extrai o conteúdo do site da Amazon sobre iPhone")

# Browser extraction (for JS-heavy/Cloudflare sites)
data = client.browser_extract("https://site-com-cloudflare.com")

# Image analysis (OCR + VLM)
vision = client.vision("https://example.com/foto.jpg")
print(vision.ocr_text)

# Audio/video transcription
transcript = client.transcribe("https://youtube.com/watch?v=...")

# RAG query
answer = client.query("como funciona a RAG do Arachne?", kb_id=1)

# Tool chaining (multiple tools in sequence or parallel)
results = client.chain([
    {"tool": "arachne_search", "args": {"query": "iPhone 16"}},
    {"tool": "arachne_search", "args": {"query": "Samsung S25"}},
], parallel=True)
```

## Why Arachne?

- **18+ tools** — search, scrape, browser, vision, transcribe, RAG, health, workflows
- **Smart Router** — tell it what you want in plain language, it picks the tool
- **Tool Chaining** — run multiple tools in sequence or parallel
- **Memory Cache** — repeated calls return instantly
- **Anti-bot evasion** — Playwright + Camoufox + fingerprint rotation for tough sites
- **On-premise** — self-hosted, no data leaves your infra

## License

MIT
