Metadata-Version: 2.4
Name: outlink-extractor
Version: 0.1.1
Summary: Extract outbound links from a URL into a CSV file from the command line.
Author-email: Amal Alexander <amalalex95@gmail.com>
License: MIT
Project-URL: Homepage, https://example.com/outlink-extractor
Project-URL: Source, https://example.com/outlink-extractor
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.0.0
Requires-Dist: beautifulsoup4>=4.9.0

# outlink-extractor

A small Python tool to quickly extract **outbound links** from any given URL and export them into a CSV file.

**Developed by: Amal Alexander**  
**Email:** [amalalex95@gmail.com](mailto:amalalex95@gmail.com)

---

## Features

- Simple CLI command.
- Fetches a web page and parses all `<a>` tags.
- Filters only external (outbound) links.
- Exports results to `outlink.csv` (or a custom file name) in the current directory.

Each row in the CSV contains:

- `href` – Absolute URL of the outbound link  
- `anchor_text` – Cleaned anchor text  
- `rel` – rel attribute value (if present)  
- `target` – target attribute value (if present)

---

## Installation

You can install it locally from the source:

```bash
pip install .
```

Or, if you have the ZIP file:

```bash
pip install outlink-extractor.zip
```

(Replace with the actual path to your ZIP.)

---

## Usage

After installation, run from your terminal:

```bash
outlink-extractor https://example.com
```

This will create `outlink.csv` in the current directory.

You can also specify a custom output file:

```bash
outlink-extractor https://example.com -o my-outlinks.csv
```

---

## Notes

- Requires Python 3.8+
- Uses `requests` and `beautifulsoup4` under the hood.
- Intended for quick SEO checks, audits, and outbound link analysis.

---
