Tianmao

# Tianmao (天猫) Skill

Simple browser launcher for Tmall.com (天猫) e-commerce platform.

## Description

This skill helps users quickly open the Tmall (天猫) website in their browser. It's designed to be a simple, no-frills utility that guides users to the correct Tmall URLs (tmall.com or tianmao.com) and lets them browse, shop, and complete transactions independently.

## Commands

### Open Tmall Homepage
```bash
tianmao open
```
Opens the main Tmall homepage (https://www.tmall.com) in your default browser.

### Open Tianmao (Alternative Domain)
```bash
tianmao tianmao
```
Opens the alternative domain (https://www.tianmao.com) which redirects to Tmall.

### Search on Tmall (Optional)
```bash
tianmao search "运动鞋"
```
(Optional) Opens Tmall search results for the given query. This requires more complex browser automation and may be added in future versions.

## Features

- **Simple Launch**: Just opens the browser to Tmall – no complex setup
- **Dual Domain Support**: Supports both tmall.com and tianmao.com URLs
- **User Control**: After opening the browser, users complete all shopping independently
- **No Data Collection**: Does not store any user data, cookies, or browsing history
- **Cross‑Platform**: Works on macOS, Linux, and Windows (via OpenClaw browser tool)

## Technical Implementation

### Core Implementation
The skill uses OpenClaw's built‑in `browser` tool to open the target URL. No external dependencies are required.

**Example agent usage:**
```javascript
browser({action: 'open', url: 'https://www.tmall.com', profile: 'chrome'})
```

### Script Implementation (Optional)
A standalone CLI script can be created for convenience:

```bash
#!/bin/bash
# bin/tianmao
openclaw browser open --url https://www.tmall.com
```

### Integration with Existing E‑commerce Skills
This skill is intentionally minimal. For advanced features (product search, price tracking, login automation), consider using the `taobao` or `alibaba` skills which offer full‑featured automa...

# Tianmao (天猫) CLI Tool

Simple browser launcher for Tmall.com (天猫) e-commerce platform.

## Description

This tool helps you quickly open the Tmall (天猫) website in your browser. It's designed to be a simple, no-frills utility that guides users to the correct Tmall URLs and lets them browse, shop, and complete transactions independently.

## Installation

### From Source

```bash
# Clone the repository
git clone https://github.com/harrylabs0913/tianmao.git
cd tianmao

# Make the script executable
chmod +x tianmao.py

# Optional: Create a symlink for global access
ln -s $(pwd)/tianmao.py /usr/local/bin/tianmao
```

## Usage

```bash
# Open Tmall homepage
tianmao open

# Open alternative domain (tianmao.com)
tianmao tianmao

# Show help
tianmao help

# Show version
tianmao version
```

## Commands

| Command | Description |
|---------|-------------|
| `open` | Open Tmall homepage (https://www.tmall.com) |
| `tianmao` | Open alternative domain (https://www.tianmao.com) |
| `help` | Show help message |
| `version` | Show version information |

## Features

- ✅ **Simple Launch**: Just opens the browser to Tmall – no complex setup
- ✅ **Dual Domain Support**: Supports both tmall.com and tianmao.com URLs
- ✅ **User Control**: After opening the browser, users complete all shopping independently
- ✅ **No Data Collection**: Does not store any user data, cookies, or browsing history
- ✅ **Cross-Platform**: Works on macOS, Linux, and Windows

## Privacy & Security

- **No Authentication**: This tool does not handle login or authentication
- **No Data Storage**: No cookies, browsing history, or personal data is stored
- **Browser-Only**: All interaction happens in the user's own browser session
- **Transparent**: Users see exactly what URL is opened and can verify it's the legitimate Tmall site

## Requirements

- Python 3.6 or higher
- A modern web browser (Chrome, Firefox, Safari, Edge, etc.)

## Supported Platforms

- macOS
- Linux
- Windows

## Why This Tool Exist...