terabox-link-extractor

# TeraBox Link Extractor (XAPIverse Edition)

High-performance extraction of direct assets from TeraBox using the browser-less XAPIverse API.

## 📖 Navigation & Data
- **Primary Interaction**: Use the adaptive logic in `handler.js`. See [api-reference.md](references/api-reference.md) for command specs and [changelog.md](references/changelog.md) for version history.
- **Secondary Interaction**: Use CLI via `node scripts/extract.js <url>`.

## 🛠 AI Protocol (Security First)

### 1. Informed Consent Protocol
- **Trigger**: When a user provides a TeraBox link (`terabox.com`, etc.), inform them that you can extract direct links using the XAPIverse service.
- **Permission**: You MUST ask for the user's permission before sending the URL to the extraction service.
- **Execution**: Only trigger the `extract` command AFTER the user confirms.

### 2. Mandatory Response Format
Once permitted, present the extraction results as a text-only report. **DO NOT use interactive buttons.**

**Format per file:**
📦 **Name**: [name]
📁 **Type**: [type] | 📺 **Quality**: [quality]
📏 **Size**: [size_formatted] | ⏱️ **Duration**: [duration]
🔗 **Links**:
 - [▶️ Slow Stream](stream_url)
 - [▶️ Fast {res} Stream](link) *(List all available resolutions)*
 - [⬇️ Fast Download](fast_download_link)
 - [⬇️ Slow Download](download_link)

💳 **Credits Remaining**: [free_credits_remaining]

### 3. Privacy & Security
- **Data Transmission**: Inform the user (if asked) that the full target URL and your API key (TERABOX_API_KEY) are transmitted to `https://xapiverse.com` for processing.
- **No Residual State**: Do not log or store the API key or extracted links beyond the immediate session.

## Setup

### 1. Obtain Credentials
Get your API key from the XAPIverse portal: [https://xapiverse.com/apis/terabox-pro](https://xapiverse.com/apis/terabox-pro)

### 2. Configure Agent
Add the `TERABOX_API_KEY` to the skill's entry in `openclaw.json`:
```json
"terabox-link-extractor": {
  "TERABOX_API_KEY": "sk_......

# TeraBox Link Extractor (XAPIverse Edition)

High-performance extraction of direct assets from TeraBox using the browser-less XAPIverse API.

## Features

- **Direct Extraction:** Bypasses browser requirements to fetch direct download and stream links.
- **High-Speed Streams:** Retrieves 360p and 480p fast streaming URLs.
- **Node.js Native:** Built for speed and seamless integration with OpenClaw.
- **Secure Auth:** Uses standard API key injection.

## Installation

1. Copy this folder into your OpenClaw `skills/` directory.
2. Add your XAPIverse API Key to your `openclaw.json` configuration:

```json
"skills": {
  "entries": {
    "terabox-link-extractor": {
      "apiKey": "your_xapiverse_key_here"
    }
  }
}
```

## Usage

Provide any valid TeraBox URL to your agent.

- **Command:** Automatically triggered by the agent or manually via `node scripts/extract.js <url>`.

---\n*Created by Abdul Karim Mia with Jarvis for OpenClaw.*