first commit

2026-06-03 20:12:56 +00:00 · 2025-09-25 23:04:11 +02:00
commit fb6456775e
13 changed files with 8867 additions and 0 deletions
@@ -0,0 +1,73 @@
+# Zonerama Scraper (Go + Geziyor)
+
+Blazing-fast JSON API to scrape Zonerama albums and photos using [geziyor/geziyor](https://github.com/geziyor/geziyor).
+
+- Input: Zonerama profile/link page, e.g. `https://eu.zonerama.com/Fcbizoni/1419417`
+- Output: JSON listing albums and photos.
+- Photo links are normalized to `https://eu.zonerama.com/photos/{photoID}_1500x1000.jpg`.
+
+## Requirements
+- Go 1.22+
+
+## Install deps
+```
+go get -u github.com/geziyor/geziyor
+```
+
+## Run the server
+```
+go run ./...
+```
+The server listens on `http://localhost:8080`.
+
+## API
+
+See full endpoint reference in `API.md`.
+
+### Endpoints
+- `/zonerama`
+- `/zonerama-album`
+
+### Common query parameters
+- `rendered` (bool, default: `true`) — Enable/disable JS rendering. Aliases: `no-render=true` or `no_render=true` to disable.
+- `debug` (bool, default: `false`) — If `true`, saves fetched HTML into `debuging/` and serves at `/debuging/`.
+
+### /zonerama
+Scrape albums and their photos starting from a Zonerama profile (account) or page URL.
+
+Params:
+- `link` (required): A Zonerama URL (profile or album link)
+- `album_limit` (int, default: `5`): Max albums to process from a profile (`0` = no limit)
+- `photo_limit` (int, default: `10`): Max photos per album (`0` = no limit)
+- `concurrency` (int, default: `8`): Max concurrent album fetches when rendering (capped by `album_limit`)
+
+Example:
+```
+curl "http://localhost:8080/zonerama?link=https://eu.zonerama.com/Fcbizoni/1419417&album_limit=3&photo_limit=25" | jq .
+```
+
+### /zonerama-album
+Scrape a single album by URL (link must contain `/Album/`).
+
+Params:
+- `link` (required): `https://eu.zonerama.com/<Account>/Album/<AlbumId>`
+- `photo_limit` (int, default: `10`): Max photos from the album (`0` = no limit)
+
+Example:
+```
+curl "http://localhost:8080/zonerama-album?link=https://eu.zonerama.com/SomeAccount/Album/13903610&photo_limit=25" | jq .
+```
+
+## Notes
+- This scraper parses:
+  - Albums from the main/profile page by selecting `li.list-alb` and reading `data-url` or the nested anchor `href`.
+  - Photos from each album page via `div.gallery-inner[data-type='photo']` and its `data-id` (photo ID).
+- For each photo ID, it builds `https://{host}/photos/{id}_1500x1000.jpg`.
+- If Zonerama changes their HTML structure, selectors may need to be updated.
+
+Server starts at `:8080`. CORS is enabled.
+
+For full details and response schemas, see `API.md`.
+
+## Disclaimer
+Be respectful of Zonerama's terms of service and rate limits. This project is for educational purposes.