Content
# Tool List
`xiaohongshuritter` is an enterprise-level Little Red Book MCP system, supporting multi-tenancy, multi-accounting, concurrency control, and three deployment methods: `Docker deployment`, `source code deployment`, and `OpenClaw deployment`.
Applicable scenarios:
- Multiple brands and business lines within an enterprise share a set of Little Red Book automation services.
- Multiple operation accounts are uniformly connected to MCP, and the AI client calls according to `tenant_id` and `account_id` routing.
- Stable deployment is required in environments such as `Windows`, `macOS`, `Linux`, `Docker`, and `OpenClaw`.
- Automated capabilities such as text and video publishing, searching, commenting, and data querying are required.
## System Architecture Diagram
```mermaid
flowchart LR
subgraph "Invocation Entrance"
A["OpenClaw"]
B["Internal AI Application"]
C["Operation and Maintenance Script / Management Terminal"]
end
A --> D["MCP Endpoint (/mcp)"]
B --> D
C --> E["HTTP API (/api/v1/*)"]
D --> F["Tenant and Account Routing Layer"]
E --> F
F --> G["Concurrency Controller"]
G --> H["Login Status and Session Management"]
H --> I["Browser Automation Layer"]
I --> J["Little Red Book Platform"]
F --> K["Account Configuration accounts.json"]
H --> L["Cookie Isolation Storage"]
G --> M["Health Check / Audit / Monitoring"]
```
## Deployment Process Diagram
```mermaid
flowchart TD
A["Get Warehouse Source Code"] --> B["Select Deployment Method"]
B --> C["Docker Deployment"]
B --> D["Source Code Deployment"]
B --> E["OpenClaw Deployment"]
C --> F["Configure accounts.json"]
D --> F
E --> G["Select Delivery Package<br/>openclaw-lite / openclaw-source-lite"]
G --> F
F --> H["Start Service"]
H --> I["Check /health"]
I --> J["Check /api/v1/accounts"]
J --> K["Register MCP in OpenClaw"]
K --> L["Execute QR Code Login"]
L --> M["Start Business Calls such as Publishing / Searching / Commenting"]
```
## Core Capabilities
- Multi-tenancy isolation: distinguish enterprises, brands, or business lines through `tenant_id`.
- Multi-account routing: manage multiple accounts under the same tenant through `account_id`.
- Concurrency control: support global concurrency and single account concurrency upper limit.
- MCP + HTTP API: provide both MCP service entrance and HTTP management interface.
- Account status management: support login detection, QR code login, and Cookie isolation.
- Multi-platform deployment: support standard Docker, source code operation, and OpenClaw call.
## Function Overview
- Login status check
- Login QR code acquisition
- Text note publishing
- Video note publishing
- Recommended flow acquisition
- Keyword search
- Note details acquisition
- Commenting and replying
- Current account list and concurrency status query
## Deployment Methods
| Scenario | Recommended Method | Documentation |
| --- | --- | --- |
| Standard Server Deployment | Docker | [docs/docker_deployment.md](./docs/docker_deployment.md) |
| Local Development and Secondary Development | Source Code Deployment | [docs/source_deployment.md](./docs/source_deployment.md) |
| OpenClaw Integration | OpenClaw Deployment | [docs/openclaw_deployment.md](./docs/openclaw_deployment.md) |
| Apple Silicon | macOS M4 Guide | [docs/macos_m4_openclaw.md](./docs/macos_m4_openclaw.md) |
| Windows Enterprise Environment | Windows Guide | [docs/windows_enterprise.md](./docs/windows_enterprise.md) |
## Quick Start
### 1. Prepare Account Configuration
```bash
cp configs/accounts.enterprise.example.json configs/accounts.json
```
Minimum example:
```json
{
"default_tenant": "default",
"default_account": "main",
"global_max_concurrency": 12,
"tenants": [
{
"id": "default",
"default_account": "main",
"accounts": [
{
"id": "main",
"cookie_path": "./data/default/main/cookies.json",
"max_concurrency": 3
}
]
}
]
}
```
### 2. Start Service
Docker:
```bash
docker compose -f docker/docker-compose.yml up -d
```
Source code:
```bash
go run .
```
### 3. Verify Service
```bash
curl http://127.0.0.1:18060/health
curl http://127.0.0.1:18060/api/v1/accounts
```
### 4. MCP Address
```text
http://127.0.0.1:18060/mcp
```
## OpenClaw Call Example
```json
{
"tenant_id": "default",
"account_id": "main",
"title": "Enterprise Content Publishing Example",
"content": "Supports multi-tenancy, multi-accounting, and concurrent publishing.",
"images": ["/app/images/demo.jpg"],
"tags": ["Content Operation", "Enterprise Publishing"],
"visibility": "Publicly Visible"
}
```
## Delivery Package
The repository contains package templates suitable for OpenClaw and operation and maintenance delivery:
- [package/README.md](./package/README.md)
- [package/openclaw-lite/README.md](./package/openclaw-lite/README.md)
- [package/openclaw-source-lite/README.md](./package/openclaw-source-lite/README.md)
Description:
- `openclaw-lite` is suitable for standard Docker / Linux amd64 environments.
- `openclaw-source-lite` is suitable for ARM64, Chromium pre-installed, and OpenClaw stable delivery.
## Document Navigation
- Enterprise-level capability description: [docs/enterprise_deployment.md](./docs/enterprise_deployment.md)
- HTTP API documentation: [docs/API.md](./docs/API.md)
- Enterprise API extension: [docs/API_ENTERPRISE.md](./docs/API_ENTERPRISE.md)
- OpenClaw MCP full manual: [docs/OPENCLAW_MCP_USAGE.md](./docs/OPENCLAW_MCP_USAGE.md)
- Docker deployment: [docs/docker_deployment.md](./docs/docker_deployment.md)
- Source code deployment: [docs/source_deployment.md](./docs/source_deployment.md)
- OpenClaw deployment: [docs/openclaw_deployment.md](./docs/openclaw_deployment.md)
## Reference Project Description
This project refers to and extends the open-source project [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) in design and implementation, and adds enterprise-level multi-accounting, multi-concurrency, OpenClaw delivery, Docker, and multi-platform deployment capabilities.
See [NOTICE.md](./NOTICE.md) for further details.
## Open Source Collaboration
- Change record: [CHANGELOG.md](./CHANGELOG.md)
- Security instructions: [SECURITY.md](./SECURITY.md)
- Community code of conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
- Contribution instructions: [CONTRIBUTING.md](./CONTRIBUTING.md)
## Compliance Reminder
Please use this project within the scope of account authorization, platform rules, and local laws and regulations. When involving write operations such as publishing, commenting, and liking, it is recommended to access audit, current limiting, and auditing processes.
