# Page Meta Extractor

[![Rust](https://img.shields.io/badge/rust-stable-brightgreen.svg)](https://www.rust-lang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub release](https://img.shields.io/github/release/EgorHenek/pages-meta.svg)](https://github.com/EgorHenek/pages-meta/releases)
[![Docker](https://img.shields.io/docker/pulls/henek/pages-meta.svg)](https://hub.docker.com/r/henek/pages-meta)

Page Meta Extractor is an HTTP service that takes a URL as input and returns JSON with page meta tags extracted from the specified URL.

## Features

- Extract page title, description, favicon, and web app manifest information
- Support for HTTP and HTTPS URLs
- JSON output for easy integration with other services

## Installation

### From Binary (Release Page)

1. Go to the [Releases](https://github.com/EgorHenek/pages-meta/releases) page
2. Download the latest binary for your platform
3. Make the binary executable: `chmod +x pages-meta`
4. Run the binary: `./pages-meta`

### Using cargo-binstall

If you have `cargo-binstall` installed:

```
cargo binstall pages-meta
```

### Using Cargo Install

If you have Rust and Cargo installed:

```
cargo install pages-meta
```

### Using Docker

```
docker pull henek/pages-meta
docker run -p 3000:3000 henek/pages-meta
```

## Configuration

The application can be configured using the following environment variables:

- `HOST`: The host address to bind the server to (default: 127.0.0.1)
- `PORT`: The port number to listen on (default: 3000)

Example:

```
HOST=0.0.0.0 PORT=8080 ./pages-meta
```

## Usage

### Web Frontend

You can also interact with the service using the web frontend available at [https://pages-meta.henek.ru/](https://pages-meta.henek.ru/).

#### Example

1. Open the web frontend in your browser: [https://pages-meta.henek.ru/](https://pages-meta.henek.ru/).
2. Enter the URL `https://example.com` in the input field.
3. Click the "Extract" button.
4. The extracted meta information will be displayed in JSON format.

### API Usage

Send a GET request to the service with the URL you want to extract meta information from:

```
http://localhost:3000/https://example.com
```

The service will return a JSON response with the extracted meta information.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.