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 sharing a set of Little Red Book automation services
- Multiple operation accounts unified and connected to MCP, with AI clients routing calls by `tenant_id` and `account_id`
- Stable deployment required on `Windows`, `macOS`, `Linux`, `Docker`, `OpenClaw`, and other environments
- Automated capabilities such as post publishing, video publishing, search, comments, and data query are needed
## System Architecture Diagram
```mermaid
flowchart LR
subgraph "Call Entrance"
A["OpenClaw"]
B["Internal AI Application"]
C["Operation 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 / Search / Comments"]
```
## Core Capabilities
- Multi-tenancy isolation: distinguished by `tenant_id` for enterprises, brands, or business lines
- 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
- Post publishing
- Video publishing
- Recommended stream acquisition
- Keyword search
- Note details acquisition
- Comment and reply
- 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": "Support 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 environment
- `openclaw-source-lite` is suitable for ARM64, Chromium preset, 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 is based on the open-source project [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp), and extends 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 description: [SECURITY.md](./SECURITY.md)
- Community code of conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
- Contribution description: [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 audit processes.
