Metadata-Version: 2.4
Name: aduankonten-client
Version: 0.1.0
Summary: Headless HTTP client for aduankonten.id (submit content reports and resolve tickets without a browser).
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.9
Requires-Dist: curl-cffi>=0.6
Provides-Extra: test
Requires-Dist: pytest>=7; extra == 'test'
Description-Content-Type: text/markdown

# aduankonten-client

A headless HTTP client for [aduankonten.id](https://aduankonten.id), Indonesia's Komdigi
portal for reporting negative online content.

The site sits behind Cloudflare Turnstile, so a headless browser can't get through. This
client skips the browser and talks to the site's own HTTP endpoints with a TLS fingerprint
Cloudflare accepts (`curl_cffi` impersonating Chrome) — the same requests the site's own
frontend makes. It works on a server, in a container, or in CI, with no display.

## Install

```bash
pip install aduankonten-client
```

## Usage

```python
from aduankonten_client import AduanKontenClient

client = AduanKontenClient()

# Submit one report (attach your own screenshot PNG if you have one).
result = client.submit(
    url="http://example-phishing-site.test",
    reason="Phishing page impersonating a bank login.",
    screenshot=open("evidence.png", "rb").read(),  # optional
)
print(result)  # {"ticket": "AK-...", "detail_url": "https://aduankonten.id/submission/detail/..."}

# Resolve an existing ticket number to its detail-page URL.
print(client.check("AK-XXXXXXXX"))
```

## Responsible use

aduankonten.id is a **real government service**. Every `submit()` files a real report that a
human reviews. Report only content you have genuinely verified, one report per case, and do
not use this to bulk-fire or spam the portal. You are responsible for what you submit.

## License

MIT
