walla-cli 0.1.0__py3-none-any.whl

walla_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,204 @@
+Metadata-Version: 2.5
+Name: walla-cli
+Version: 0.1.0
+Summary: Wallapop.es CLI - look · offer · talk for humans and agents
+Project-URL: Homepage, https://github.com/berendgort/wallapop-cli
+Project-URL: Repository, https://github.com/berendgort/wallapop-cli
+Project-URL: Issues, https://github.com/berendgort/wallapop-cli/issues
+Author-email: "Dr. Berend Gort" <berend.gort@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,marketplace,mcp,spain,wallapop
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.7.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: rich>=13.8.0
+Requires-Dist: tenacity>=9.0.0
+Requires-Dist: typer>=0.15.1
+Provides-Extra: all
+Requires-Dist: build>=1.2.0; extra == 'all'
+Requires-Dist: fastmcp>=3.2; extra == 'all'
+Requires-Dist: mcp>=1.2.0; extra == 'all'
+Requires-Dist: mypy>=1.14.0; extra == 'all'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'all'
+Requires-Dist: pytest>=8.3.4; extra == 'all'
+Requires-Dist: ruff>=0.8.4; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: build>=1.2.0; extra == 'dev'
+Requires-Dist: mypy>=1.14.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.4; extra == 'dev'
+Requires-Dist: ruff>=0.8.4; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=3.2; extra == 'mcp'
+Requires-Dist: mcp>=1.2.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# walla
+
+```
+██╗    ██╗  █████╗  ██╗      ██╗       █████╗            ██████╗ ██╗      ██╗
+██║    ██║ ██╔══██╗ ██║      ██║      ██╔══██╗          ██╔════╝ ██║      ██║
+██║ █╗ ██║ ███████║ ██║      ██║      ███████║  █████╗  ██║      ██║      ██║
+██║███╗██║ ██╔══██║ ██║      ██║      ██╔══██║  ╚════╝  ██║      ██║      ██║
+╚███╔███╔╝ ██║  ██║ ███████╗ ███████╗ ██║  ██║          ╚██████╗ ███████╗ ██║
+ ╚══╝╚══╝  ╚═╝  ╚═╝ ╚══════╝ ╚══════╝ ╚═╝  ╚═╝           ╚═════╝ ╚══════╝ ╚═╝
+  look · offer · talk
+  Dr. Berend Gort  ·  www.berendgort.dev
+```
+
+![walla banner](docs/assets/walla-github-banner.jpg)
+
+**walla** is an unofficial Wallapop.es **CLI + MCP + Python library** for Cursor
+agents and humans: search listings, read inbox, send a message, make an offer.
+
+Not affiliated with Wallapop. Respect ToS and rate limits.
+
+### What this unlocks
+
+You tell Cursor: *“Find me a used kite near Barcelona under €400, message
+the seller, and offer if it’s a GRAB.”*
+
+The agent runs `walla` — ranks listings **GRAB / LOOK / PASS**, links you the
+item, asks before sending, then talks and offers on your behalf:
+
+```bash
+walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --budget 400
+walla search "tabla kite Cabrinha" --max 40 --json
+# agent: GRAB · Cabrinha Moto 10m · €320 · 4 km
+#        https://es.wallapop.com/item/...
+
+walla login                         # paste session cookie once
+walla say <id> "Hola, ¿sigue disponible? Puedo pasar hoy." --yes
+walla offer <id> --eur 280 --yes    # prints total; needs your confirm
+walla inbox --json                  # catch the reply
+```
+
+That is the product: a Cursor agent that can **look, talk, and offer** on
+Wallapop without opening the website for every step.
+
+**Quality bar (enforced in CI):**
+
+- [`docs/code_quality.md`](docs/code_quality.md) — Korotkevich / Tourist bar
+- [`docs/data_engineering_standards.md`](docs/data_engineering_standards.md) — Gray / Stonebraker bar
+- [`docs/WIRE.md`](docs/WIRE.md) — captured consumer API
+- [`docs/rate_limit_analysis.md`](docs/rate_limit_analysis.md) — polite spacing
+
+---
+
+## For AI agents (mandatory protocol)
+
+If the user pasted this GitHub link (or this README), **follow this section exactly**.
+
+### Goal
+
+Look, offer, and talk on wallapop.es using the `walla` package. Speak briefly.
+Link listings as `https://es.wallapop.com/item/<web_slug>`. Verdicts:
+**GRAB / LOOK / PASS**.
+
+### Bootstrap
+
+1. Install from this clone:
+   ```bash
+pipx install 'walla-cli[mcp]'
+# from clone: pipx install -e '.[mcp]'
+```
+2. `walla doctor --json` — read `auth.session` and `network.reachable`.
+   **Never** print tokens or cookies.
+3. If no session: ask the human to run `walla login` and paste
+   `__Secure-next-auth.session-token` from es.wallapop.com (Cookie-Editor).
+   Agents may pass it non-interactively: `walla login --cookie '<value>' --json`.
+4. Do the ask with `walla … --json` and narrate in prose.
+
+Optional MCP:
+
+```json
+{
+  "mcpServers": {
+    "walla": { "command": "walla-mcp" }
+  }
+}
+```
+
+### Operating loop
+
+| Ask | Command |
+|-----|---------|
+| Look | `walla search "tabla kite" --max 40 --json` then `walla item <id> --json` |
+| Talk | `walla inbox --json` · `walla thread <id> --json` · `walla say <id> "…" --yes` |
+| Offer | `walla offer <id> --eur 180 --yes` |
+
+Rules:
+
+- Reads are safe. `say` / `offer` need `--yes` / `confirm=true`. Name listing + euros.
+- If they only asked to look, do not send.
+- Ambiguous match: ask once with candidates.
+- In-person offers outside pickup radius: refuse.
+- Envelope: `ok`, `api_version`, `data` or `error` / `error_type` / `retryable`.
+
+`walla instruct --json` returns this recipe.
+
+---
+
+## Install
+
+```bash
+git clone git@github.com:berendgort/wallapop-cli.git
+cd wallapop-cli
+pipx install 'walla-cli[mcp]'   # or: pipx install -e '.[mcp]'
+walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --json
+walla login          # paste __Secure-next-auth.session-token
+walla doctor --json
+```
+
+## CLI
+
+| Command | Role |
+|---------|------|
+| `walla setup` / `profile` | Home point, radius, budget |
+| `walla search` / `item` / `categories` | Look |
+| `walla watch add\|list\|check` | Local saved searches |
+| `walla login` / `logout` / `whoami` | Session (paste cookie; optional `--password`) |
+| `walla inbox` / `thread` / `say` | Talk |
+| `walla offer` | Offer (prints total, needs `--yes`) |
+| `walla fav list\|add\|rm` | Favorites |
+| `walla instruct` / `doctor` | Agent recipe + health |
+
+## Develop
+
+```bash
+pip install -e '.[dev,mcp]'
+pytest -q -m 'not live'
+pytest -m live          # hits Wallapop; needs network
+ruff check .
+mypy walla
+python scripts/check_code_quality.py
+```
+
+| Layer | Path | Role |
+|-------|------|------|
+| Models | `walla/models/` | Pydantic only |
+| HTTP | `walla/http/` | curl_cffi + polite |
+| Core | `walla/core/` | Envelope, errors, human_fix |
+| Search | `walla/search/` | Look |
+| Account | `walla/account/` | Session, inbox, offer |
+| Hunter | `walla/hunter/` | Profile, watches, verdicts |
+| CLI / MCP | `walla/cli/` · `walla/mcp/` | Entrypoints |
+
+Read [`AGENTS.md`](AGENTS.md) before extending.
+
+## Disclaimer
+
+Unofficial. Not affiliated with Wallapop. Personal / research use.
+
+## License
+
+MIT

walla_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+walla/__init__.py,sha256=CyY4P8n33vxvTrs7-BxqV5pRvez9DvkXHo3ELPc8GA4,136
+walla/account/__init__.py,sha256=IiEPza1OmTKtxc5ROaa180mxrNnbzuUSEnDr--63cew,642
+walla/account/actions.py,sha256=JSI4Anj8wcbI4ZonkQ3DHE8t_58115fdC40wxm4WTMs,4437
+walla/account/cookies.py,sha256=IfZQG-DtyFoFYvLutjeaWHEGiGGXW3WR7zI508p0h28,2985
+walla/account/inbox.py,sha256=Kh7DoU3XPstas8Vq9iHzBJr26fHe7Q9AiSbGZCMzKJY,4983
+walla/account/login.py,sha256=uyllsSH5nHPwqEvN8SmiA1xlQS6lC8Fe14nGnm-GNjg,7710
+walla/account/prompt.py,sha256=vS7VE4O1P3HSrfXQSO9sWPbKxdzoHrvJq9MYjMisQOk,1678
+walla/account/session_store.py,sha256=zV9BMkv5MzPL2e2iyXVWsh7Ib7tpRyy8VPDe4mGLsT0,904
+walla/cli/__init__.py,sha256=FNjXRaqT2swXeycsAIinAnZef_EJVaOjD50x2bN8Mq4,118
+walla/cli/banner.py,sha256=fL8_ysab0X0OTHzez-HwlB_wbTsVtrTBJ5uzXoFMDSM,1689
+walla/cli/catch.py,sha256=35-UPkeLheC7VEul5IvNIb8zWcYG4lmAJ5rC2lYpiuE,1159
+walla/cli/cmd_account.py,sha256=W17Czf9En0h5rqIMFxOJC-KpHAmT11UFaX3MHzLvobU,5510
+walla/cli/cmd_look.py,sha256=PQUMCS73L6ZFbktxTWRrp8IhbJrrF_cVCVi8jOhMVY4,5041
+walla/cli/cmd_ops.py,sha256=A5A2BF-KkjLTzj1zqolQoaeldcvPwSfvVrmghoNHqUQ,3477
+walla/cli/console.py,sha256=x9tdiCTw2ObLkHVHSWPCCfZBnt361twI5Kd6XY636qo,150
+walla/cli/main.py,sha256=9v_tpnpUdMz_T7rkwWN7fDojSG5CRQPK3b9MX0YRQkY,904
+walla/core/__init__.py,sha256=kBMCGF-T8i7sZMhNFa8FfPKk3WxgyTScxbvOWAKeVIU,249
+walla/core/envelope.py,sha256=fuOt-MePHLf_kjjOASo5tI5Rn52F501cSEEO5lAdrxU,1211
+walla/core/errors.py,sha256=ecgLwF8Kj5CYBMu9qllKo6_xx55HOhtcJOPQ_PeoJNU,3125
+walla/core/exceptions.py,sha256=9XvBg3UgeMdf1SMRG1cAEJ_uNBwq9_3j8o08qhHgnbo,1502
+walla/core/human_fix.py,sha256=vO7cdP89QRsXGns2HA49V0h6kfxt_-iJX4-6h4QrGXQ,746
+walla/core/instruct.py,sha256=q9fRmbm0FLpC6LtaSQyLQ2_cpbOHsM0DOecE27vPh90,1992
+walla/core/path.py,sha256=e4mXBTWTWfo5CAnUCU_-dtc-aLKq2Qgx8oArIA4_IBg,639
+walla/http/__init__.py,sha256=DOX7fh7rELVOAk79vOtbT17mzb2TP9ZvO8RYoBRzFMo,283
+walla/http/client.py,sha256=jjW_hiddZVRUt0HJcZ56GHBR20Y9olyYYPgSlDPEPYI,4975
+walla/http/headers.py,sha256=MvOlVb2AyXjogh_YR4sRsLjujqwLutEwX15paJgXBDg,835
+walla/http/polite.py,sha256=mcFrM33rSUdFCnP-IGIoyhv9DQXGRmOU0tTmjthfQg8,3085
+walla/hunter/__init__.py,sha256=Owth0gw66E-oB7fXfcFoD87UP-Mr3pkD8-1X0yrDgZM,443
+walla/hunter/profile_store.py,sha256=pFP1-0RssJvhcqcSAEUEZHPQOWw2UPRrhoc4WLq3Tg4,1596
+walla/hunter/verdict.py,sha256=aeB4188R96lY9hEy9gGNxhAODpd1S7CL3bIQyUWNAgk,1465
+walla/hunter/watches.py,sha256=BQw-BaLd4iBE5O2jDstT_y5v1yndpa12B9ThdRAlWYU,1495
+walla/mcp/__init__.py,sha256=wwkrAWL7wVgWdBpU7Ec8Ih-eiGZMcvQjtx5WwFvtc6E,130
+walla/mcp/_entry.py,sha256=ZQwyTHjGsoHVOxIF7-Q_DSh-x1clsD-cLvMqAxMiVQ8,337
+walla/mcp/server.py,sha256=ZhqEbkBo4CFpxdGplt7rX5IISItk6-I-OpvbnTQXr3s,4241
+walla/models/__init__.py,sha256=aZpliNuyQ6ein3Racqulaq91Fcz1nWYM0_l7NodqN54,397
+walla/models/account.py,sha256=vTzQQcDe32Q8ZlWNJlm2UBts4d7pZQs8ZMprl9LXiTo,997
+walla/models/listing.py,sha256=7y9pEknX2POJYR9koczON87A5dcBbpqYseHflPOvzfw,1123
+walla/models/profile.py,sha256=BIXrr7LldXYTtynHIQWafgwt7pLAeN3cD64v5mhO6sQ,774
+walla/search/__init__.py,sha256=RxCmZLqpTs7UUdnCu3n57SZhoMi2BD817HJc6yLLTFg,349
+walla/search/api.py,sha256=Ft8SQkMG9vxC1bXurR-Ix1SjHG9qeq-LgfkfPZkLV5I,2327
+walla/search/parse.py,sha256=a6bv9pRntDWxuSeBMzZZa_pQSdG-HVD3YraIysRDb8k,5407
+walla_cli-0.1.0.dist-info/METADATA,sha256=MWDX1jpPmAHGoPdUGNRUOzTV3dzUakPAgJ03jJPeqDA,7546
+walla_cli-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+walla_cli-0.1.0.dist-info/entry_points.txt,sha256=HK9fabdyMSTUWLhfOLkmOBHsBWxPbJ1sxttV1v1bk3o,121
+walla_cli-0.1.0.dist-info/licenses/LICENSE,sha256=DLgwTKF-cmcVGGzdAv6zze9YvY5df8hUywZdH5l4kik,1072
+walla_cli-0.1.0.dist-info/RECORD,,

walla_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

walla_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+walla = walla.cli.main:cli
+walla-mcp = walla.mcp._entry:run
+walla-mcp-http = walla.mcp._entry:run_http

walla_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dr. Berend Gort
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.