Metadata-Version: 2.4
Name: parse-everything
Version: 1.0.1
Summary: Official Python SDK for Parse Everything — Bypass Cloudflare Turnstile, Akamai & DataDome with TLS JA3/JA4 impersonation.
Home-page: https://parse-everything.com
Author: Parse Everything
Author-email: support@rawmind.app
License: MIT
Project-URL: Documentation, https://parse-everything.com/docs.php
Project-URL: Source Code, https://github.com/parse-everything/parse-everything-python
Keywords: cloudflare-bypass,turnstile-solver,akamai-bypass,datadome,web-scraping-api,ja3-spoofing,ja4-fingerprinting,anti-bot,flaresolverr-alternative,zenrows-alternative,scrapingbee-alternative,crawler,web-extraction
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# Parse Everything — Python SDK

[![PyPI version](https://img.shields.io/badge/pypi-v1.0.1-blue.svg)](https://pypi.org/project/parse-everything/)
[![Free Credits](https://img.shields.io/badge/Free%20Tier-1%2C000%20Requests-green.svg)](https://parse-everything.com)
[![Python Versions](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://pypi.org/project/parse-everything/)

Official lightweight Python client for [Parse Everything](https://parse-everything.com) — Enterprise Web Scraping & Anti-Bot Bypass API.

Effortlessly bypass **Cloudflare Turnstile**, **Cloudflare WAF (403 Forbidden)**, **Akamai Bot Manager**, **DataDome**, and **DDoS-Guard** with authentic TLS JA3/JA4 fingerprint impersonation.

---

## 🚀 Quick Install

```bash
pip install parse-everything
```

*(Zero heavy browser or binary dependencies required. Uses built-in standard library).*

---

## 🔑 Get Your API Key

Sign up at [parse-everything.com](https://parse-everything.com) to receive **1,000 free API credits** instantly.

---

## 💡 Usage Examples

### 1. Simple Scrape (Bypass Cloudflare Turnstile & WAF)
```python
from parse_everything import ParseEverything

client = ParseEverything(api_key="pe_live_YOUR_API_KEY")

result = client.scrape(
    target_url="https://nowsecure.nl",
    bypass_cloudflare=True,
    render_js=False  # Handled via ultra-fast TLS impersonation in ~300ms
)

print("HTTP Status:", result["data"]["http_status"])
print("Page Title:", result["data"]["page_title"])
print("Protection Bypassed:", result["data"]["protection_bypassed"])
print("HTML:", result["data"]["full_html"][:200])
```

### 2. Extract Structured Data with CSS Selectors (LLM / RAG Ready)
```python
result = client.scrape(
    target_url="https://example.com/products",
    selectors={
        "titles": "h2.product-title",
        "prices": ".price",
        "links": "a.buy-btn"
    }
)

print(result["data"]["selectors_data"])
```

### 3. Extract Clean Text Only (Save 85% LLM Tokens)
```python
result = client.scrape(
    target_url="https://news-site.com/article",
    extract_text=True
)

print(result["data"]["clean_text"])
```

### 4. Asynchronous Batch Scraping (Up to 100 URLs)
```python
batch_job = client.batch(
    target_urls=[
        "https://example.com/page1",
        "https://example.com/page2",
        "https://example.com/page3"
    ]
)
print("Batch ID:", batch_job["batch_id"])

# Poll progress
status = client.get_batch(batch_job["batch_id"])
print(f"Status: {status['job_status']} ({status['completed_urls']}/{status['total_urls']})")
```

---

## 📦 How to Publish to PyPI

```bash
cd AD/04_sdks_and_packages/python_pypi
pip install build twine
python -m build
python -m twine upload dist/*
```
