reverse-api-engineer 0.1.0__tar.gz

reverse_api_engineer-0.1.0/.gitignore

@@ -0,0 +1,86 @@
+.DS_Store
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.manifest
+*.spec
+pip-log.txt
+pip-delete-this-directory.txt
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+*.mo
+*.pot
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+instance/
+.webassets-cache
+.scrapy
+docs/_build/
+.pybuilder/
+target/
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+__pypackages__/
+celerybeat-schedule
+celerybeat.pid
+*.sage.py
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.spyderproject
+.spyproject
+.ropeproject
+/site
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+cython_debug/
+
+# Project specific
+har/
+scripts/
+scripts_built/
+!scripts/*/api_client.py
+!scripts/*/example_usage.py
+!scripts/*/README.md
+.reverse-api/
+*.har

reverse_api_engineer-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

reverse_api_engineer-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing to Reverse API
+
+Thank you for your interest in contributing to Reverse API! This document provides guidelines and instructions for contributing.
+
+## Development Setup
+
+1. **Fork and clone the repository**
+   ```bash
+   git clone https://github.com/kalil0321/reverse-api-engineer.git
+   cd reverse-api-engineer
+   ```
+
+2. **Install dependencies**
+   ```bash
+   uv sync
+   playwright install chromium
+   ```
+
+3. **Run locally**
+   ```bash
+   uv run reverse-api-engineer
+   ```
+
+## Code Style
+
+- Follow PEP 8 guidelines
+- Use type hints where applicable
+- Add docstrings to functions and classes
+- Keep the minimalist CLI aesthetic
+
+## Pull Request Process
+
+1. Create a feature branch from `main`
+2. Make your changes
+3. Test your changes locally
+4. Submit a pull request with a clear description
+
+## Reporting Issues
+
+- Use the GitHub issue tracker
+- Include steps to reproduce
+- Provide system information (OS, Python version)
+- Include error messages and logs
+
+## Questions?
+
+Feel free to open an issue for any questions or suggestions!

reverse_api_engineer-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kalil0321
+
+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.

reverse_api_engineer-0.1.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: reverse-api-engineer
+Version: 0.1.0
+Summary: A tool to capture browser traffic for API reverse engineering
+Project-URL: Homepage, https://github.com/kalil0321/reverse-api-engineer
+Project-URL: Repository, https://github.com/kalil0321/reverse-api-engineer
+Project-URL: Issues, https://github.com/kalil0321/reverse-api-engineer/issues
+Author-email: Kalil <kalil0321@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Keywords: api,browser,claude,har,playwright,reverse-engineering
+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
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: brotli>=1.2.0
+Requires-Dist: claude-agent-sdk>=0.1.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: playwright-stealth>=1.0.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=13.0.0
+Description-Content-Type: text/markdown
+
+# 🔄 Reverse API Engineer
+
+[![PyPI version](https://badge.fury.io/py/reverse-api-engineer.svg)](https://badge.fury.io/py/reverse-api-engineer)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Reverse API** is an AI-powered tool that captures browser traffic and automatically generates production-ready Python API clients. No more manual reverse engineering—just browse, capture, and get clean API code.
+
+## ✨ Features
+
+- 🌐 **Browser Automation**: Built on Playwright with stealth mode for realistic browsing
+- 📊 **HAR Recording**: Captures all network traffic in HTTP Archive format
+- 🤖 **AI-Powered Generation**: Uses Claude 4.5 to analyze traffic and generate clean Python code
+- 💻 **Interactive CLI**: Minimalist terminal interface with mode cycling (Shift+Tab)
+- 📦 **Production Ready**: Generated scripts include error handling, type hints, and documentation
+- 💾 **Session History**: All runs saved locally with full message logs
+- 💰 **Cost Tracking**: Detailed token usage and cost estimation with cache support
+
+## 🚀 Installation
+
+### Using pip
+```bash
+pip install reverse-api-engineer
+```
+
+### Using uv (recommended)
+```bash
+uv tool install reverse-api-engineer
+```
+
+### From source
+```bash
+git clone https://github.com/kalil0321/reverse-api-engineer.git
+cd reverse-api-engineer
+uv sync
+```
+
+### Post-installation
+Install Playwright browsers:
+```bash
+playwright install chromium
+```
+
+## 📖 Usage
+
+### Quick Start
+
+Launch the interactive CLI:
+```bash
+reverse-api-engineer
+```
+
+The CLI has two modes (cycle with **Shift+Tab**):
+- **manual**: Full pipeline (browser capture + AI generation)
+- **engineer**: Reverse engineer from existing run_id
+
+### Manual Mode (Full Pipeline)
+
+1. Start the CLI: `reverse-api-engineer`
+2. Enter your task description (e.g., "Fetch Apple job listings")
+3. Optionally provide a starting URL
+4. Browse and interact with the website
+5. Close the browser when done
+6. AI automatically generates the API client
+
+Generated scripts are saved to:
+- `~/.reverse-api/runs/scripts/{run_id}/` (permanent storage)
+- `./scripts/{descriptive_name}/` (local copy with readable name)
+
+### Engineer Mode (Re-process existing captures)
+
+Re-run AI generation on a previous capture:
+```bash
+# In CLI, switch to engineer mode (Shift+Tab) and enter run_id
+# Or use command line:
+reverse-api-engineer engineer <run_id>
+```
+
+### CLI Commands
+
+While in the CLI, use these slash commands:
+- `/settings` - Configure model and output directory
+- `/history` - View past runs with costs
+- `/messages <run_id>` - View detailed message logs
+- `/help` - Show all commands
+- `/exit` - Quit
+
+### Model Selection
+
+Choose from Claude 4.5 models:
+- **Sonnet 4.5** (default): Balanced performance and cost
+- **Opus 4.5**: Maximum capability for complex APIs
+- **Haiku 4.5**: Fastest and most economical
+
+Change model in `/settings` or via CLI:
+```bash
+reverse-api-engineer manual --model claude-sonnet-4-5
+```
+
+## 🔧 Configuration
+
+Settings are stored in `~/.reverse-api/config.json`:
+```json
+{
+  "model": "claude-sonnet-4-5",
+  "output_dir": null
+}
+```
+
+## 📁 Project Structure
+
+```
+~/.reverse-api/
+├── config.json          # User settings
+├── history.json         # Run history with metadata
+└── runs/
+    ├── har/{run_id}/    # Captured HAR files
+    ├── scripts/{run_id}/ # Generated API clients
+    └── messages/{run_id}.jsonl # Full message logs
+```
+
+## 💡 Examples
+
+### Example: Reverse Engineering a Job Board API
+
+```bash
+$ reverse-api-engineer
+> fetch all apple jobs from their careers page
+
+# Browser opens, you navigate and interact
+# Close browser when done
+
+# AI generates:
+# - api_client.py (full API implementation)
+# - README.md (documentation)
+# - example_usage.py (usage examples)
+
+# Scripts copied to: ./scripts/apple_jobs_api/
+```
+
+Generated `api_client.py` includes:
+- Authentication handling
+- Clean function interfaces
+- Type hints and docstrings
+- Error handling
+- Production-ready code
+
+## 🛠️ Development
+
+### Setup
+```bash
+git clone https://github.com/kalil0321/reverse-api-engineer.git
+cd reverse-api-engineer
+uv sync
+```
+
+### Run locally
+```bash
+uv run reverse-api-engineer
+```
+
+### Build
+```bash
+uv build
+```
+
+## 🔐 Requirements
+
+- Python 3.10+
+- Anthropic API key (set as `ANTHROPIC_API_KEY` environment variable)
+- Playwright browsers installed
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

reverse_api_engineer-0.1.0/README.md

@@ -0,0 +1,179 @@
+# 🔄 Reverse API Engineer
+
+[![PyPI version](https://badge.fury.io/py/reverse-api-engineer.svg)](https://badge.fury.io/py/reverse-api-engineer)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Reverse API** is an AI-powered tool that captures browser traffic and automatically generates production-ready Python API clients. No more manual reverse engineering—just browse, capture, and get clean API code.
+
+## ✨ Features
+
+- 🌐 **Browser Automation**: Built on Playwright with stealth mode for realistic browsing
+- 📊 **HAR Recording**: Captures all network traffic in HTTP Archive format
+- 🤖 **AI-Powered Generation**: Uses Claude 4.5 to analyze traffic and generate clean Python code
+- 💻 **Interactive CLI**: Minimalist terminal interface with mode cycling (Shift+Tab)
+- 📦 **Production Ready**: Generated scripts include error handling, type hints, and documentation
+- 💾 **Session History**: All runs saved locally with full message logs
+- 💰 **Cost Tracking**: Detailed token usage and cost estimation with cache support
+
+## 🚀 Installation
+
+### Using pip
+```bash
+pip install reverse-api-engineer
+```
+
+### Using uv (recommended)
+```bash
+uv tool install reverse-api-engineer
+```
+
+### From source
+```bash
+git clone https://github.com/kalil0321/reverse-api-engineer.git
+cd reverse-api-engineer
+uv sync
+```
+
+### Post-installation
+Install Playwright browsers:
+```bash
+playwright install chromium
+```
+
+## 📖 Usage
+
+### Quick Start
+
+Launch the interactive CLI:
+```bash
+reverse-api-engineer
+```
+
+The CLI has two modes (cycle with **Shift+Tab**):
+- **manual**: Full pipeline (browser capture + AI generation)
+- **engineer**: Reverse engineer from existing run_id
+
+### Manual Mode (Full Pipeline)
+
+1. Start the CLI: `reverse-api-engineer`
+2. Enter your task description (e.g., "Fetch Apple job listings")
+3. Optionally provide a starting URL
+4. Browse and interact with the website
+5. Close the browser when done
+6. AI automatically generates the API client
+
+Generated scripts are saved to:
+- `~/.reverse-api/runs/scripts/{run_id}/` (permanent storage)
+- `./scripts/{descriptive_name}/` (local copy with readable name)
+
+### Engineer Mode (Re-process existing captures)
+
+Re-run AI generation on a previous capture:
+```bash
+# In CLI, switch to engineer mode (Shift+Tab) and enter run_id
+# Or use command line:
+reverse-api-engineer engineer <run_id>
+```
+
+### CLI Commands
+
+While in the CLI, use these slash commands:
+- `/settings` - Configure model and output directory
+- `/history` - View past runs with costs
+- `/messages <run_id>` - View detailed message logs
+- `/help` - Show all commands
+- `/exit` - Quit
+
+### Model Selection
+
+Choose from Claude 4.5 models:
+- **Sonnet 4.5** (default): Balanced performance and cost
+- **Opus 4.5**: Maximum capability for complex APIs
+- **Haiku 4.5**: Fastest and most economical
+
+Change model in `/settings` or via CLI:
+```bash
+reverse-api-engineer manual --model claude-sonnet-4-5
+```
+
+## 🔧 Configuration
+
+Settings are stored in `~/.reverse-api/config.json`:
+```json
+{
+  "model": "claude-sonnet-4-5",
+  "output_dir": null
+}
+```
+
+## 📁 Project Structure
+
+```
+~/.reverse-api/
+├── config.json          # User settings
+├── history.json         # Run history with metadata
+└── runs/
+    ├── har/{run_id}/    # Captured HAR files
+    ├── scripts/{run_id}/ # Generated API clients
+    └── messages/{run_id}.jsonl # Full message logs
+```
+
+## 💡 Examples
+
+### Example: Reverse Engineering a Job Board API
+
+```bash
+$ reverse-api-engineer
+> fetch all apple jobs from their careers page
+
+# Browser opens, you navigate and interact
+# Close browser when done
+
+# AI generates:
+# - api_client.py (full API implementation)
+# - README.md (documentation)
+# - example_usage.py (usage examples)
+
+# Scripts copied to: ./scripts/apple_jobs_api/
+```
+
+Generated `api_client.py` includes:
+- Authentication handling
+- Clean function interfaces
+- Type hints and docstrings
+- Error handling
+- Production-ready code
+
+## 🛠️ Development
+
+### Setup
+```bash
+git clone https://github.com/kalil0321/reverse-api-engineer.git
+cd reverse-api-engineer
+uv sync
+```
+
+### Run locally
+```bash
+uv run reverse-api-engineer
+```
+
+### Build
+```bash
+uv build
+```
+
+## 🔐 Requirements
+
+- Python 3.10+
+- Anthropic API key (set as `ANTHROPIC_API_KEY` environment variable)
+- Playwright browsers installed
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

reverse_api_engineer-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "reverse-api-engineer"
+version = "0.1.0"
+description = "A tool to capture browser traffic for API reverse engineering"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Kalil", email = "kalil0321@users.noreply.github.com" }
+]
+license = { text = "MIT" }
+keywords = ["api", "reverse-engineering", "browser", "har", "playwright", "claude"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = [
+    "playwright>=1.40.0",
+    "playwright-stealth>=1.0.0",
+    "click>=8.1.0",
+    "claude-agent-sdk>=0.1.0",
+    "rich>=13.0.0",
+    "questionary>=2.0.0",
+    "requests>=2.32.5",
+    "anthropic>=0.40.0",
+    "brotli>=1.2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/kalil0321/reverse-api-engineer"
+Repository = "https://github.com/kalil0321/reverse-api-engineer"
+Issues = "https://github.com/kalil0321/reverse-api-engineer/issues"
+
+[project.scripts]
+reverse-api-engineer = "reverse_api.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/reverse_api"]
+
+[dependency-groups]
+dev = []