Metadata-Version: 2.3
Name: medor
Version: 0.0.1b3
Summary: A small example package
Project-URL: Homepage, https://github.com/balestek/medor
Project-URL: Bug Tracker, https://github.com/balestek/medor/issues
Author: balestek
License: MIT License
        
        Copyright (c) 2024 balestek
        
        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.
License-File: LICENSE
Keywords: information-gathering,open-source-intelligence,osint,osint-python,osint-tool,osint-tools,pipenv,pypi,python,wordpress
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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
Requires-Python: >=3.8
Requires-Dist: colorama
Requires-Dist: docopt
Requires-Dist: halo
Requires-Dist: httpx
Description-Content-Type: text/markdown

# medor

What medor's master can say about him:
> Medor is a good dog. Provided you send him far enough, he can come back with a juicy bone.

medor is an OSINT tool for finding WordPress website IP behind a WAF (web application firewall). It requests xmlrpc.php to get the IP behind the WAF thanks to a webhook provider.

It needs several conditions to work:
+ a WordPress website with xmlrpc.php unsecured
+ a blog post from the website (not a page)

medor comes with few features :
+ [X] it works with the domain, the website url or a blog post.
+ [X] it tries to find a blog post with WordPress REST API.
+ [X] it updates and rotates user-agents.
+ [X] a proxy can be used.
+ [ ] _todo : add SOCKS5 proxy support_.
+ [ ] _todo : an optional flask server to handle the xmlrpc.php response_.
+ [ ] _todo : use list of proxies with random selection per request_.
+ [ ] _todo : check a list of domains, hosts or url_.

> [!TIP]
> Be safe, be smart, use OPSEC.

> [!CAUTION]
> Use a VPN as basic OPSEC and medor with a proxy. WAFs can temp ban your IP if you get too excited.

## Installation

### pipenv
```bash
pipenv install medor
```

### pip
```bash
pip install medor
```

## Usage

### Basic usage

```bash
medor domain.tld
```

Where domain.tld is the domain investigated.

### With proxy

Proxy format should be scheme://user.password@IP:port or scheme://IP:port

Allowed schemes : http and https

```bash
medor domain.tld -p http://user.password@IP:port
```
or
```bash
medor domain.tld --proxy=http://user.password@IP:port
```

### With site url or blog url

medor can try to find the IP with the domain (default) but as well with the site url ()