longbridge

# Longbridge

## Overview

Longbridge is the official skill collection for Longbridge Securities, covering 125+ agent skills across real-time market data, chart analysis, company fundamentals, portfolio management, options, sector screening, and more. Supports HK, US, A-share (SH/SZ), and SG markets. All skills are trilingual (Simplified Chinese / Traditional Chinese / English).

Source repository: [github.com/longbridge/skills](https://github.com/longbridge/skills) (~840 stars, MIT)

## When to Use This Skill

- Use when the user asks about stock prices, charts, or market data for HK/US/A-share/SG markets
- Use when the user wants company fundamentals, earnings, or analyst ratings
- Use when the user asks about their portfolio, positions, or account P&L via Longbridge
- Use when the user wants options analysis, sector rankings, capital flow, or news
- Use when the user asks in Chinese (Simplified or Traditional) or English about any securities topic

## How It Works

### Step 1: Discover the Right Subcommand

```bash
longbridge --help
```

List all available subcommands. Never hard-code subcommand names — the CLI evolves.

### Step 2: Check Subcommand Options

```bash
longbridge <subcommand> --help
```

Confirm flags and output format before calling.

### Step 3: Call with JSON Output

```bash
longbridge <subcommand> --format json
```

Parse the structured output and render in the user's language (detect from input).

## Authentication

```bash
longbridge auth login          # Basic market data (read-only)
longbridge auth login --trade  # Portfolio and account features
```

## Install

```bash
# Claude Code plugin marketplace
/plugin marketplace add longbridge/skills

# Or via npx
npx skills add https://github.com/longbridge/skills
```

## MCP Fallback

If the `longbridge` CLI binary is not installed, fall back to MCP tools. Inspect available MCP tools at runtime — do not hard-code MCP tool names as they change with server versions.

## Limitations

- Portfolio and account features require login with Trade scope.
- Real-time data is subject to Longbridge data subscription (delayed data available without subscription).
- Crypto symbols use `.HAS` suffix on the Longbridge platform.
- This skill does not place orders — read-only by default unless using the account write scope.

## Security & Safety Notes

- All market data queries are read-only (no side effects).
- Watchlist mutations and order-related features follow a preview + confirm two-step protocol.
- Credentials are handled by the Longbridge auth system; this skill does not store or transmit tokens.