memecoin-analyst-agent


Namememecoin-analyst-agent JSON
Version 0.1.9 PyPI version JSON
download
home_pageNone
SummaryMemecoin Smart Trading Analyst Agent with MCP server for Alibaba Cloud Bailian
upload_time2025-09-02 11:37:14
maintainerNone
docs_urlNone
authorMemecoin Trading Team
requires_python>=3.8
licenseMIT
keywords mcp agent memecoin bsc web3 analysis
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 6551 Monitor Assistant v5.3

后端直连新网站专属 WebSocket 源,实时消费推送,进行用户/关键词匹配并将命中的代币地址发送到 Sigma Bot。Chrome 插件不再必须,只保留为可选 UI。

**🌐 跨平台支持:完全兼容 Windows、macOS 和 Linux 系统**

## Core Features

- **Real-time Monitoring**: Multiple DOM monitoring strategies to ensure no content is missed.
- **Intelligent Matching**: Case-insensitive keyword matching with a customizable mapping table.
- **Terminal Broadcasting**: Color-coded terminal output with sound alerts.
- **Desktop Notifications**: Native Chrome notification system.
- **Real-time Statistics**: Match history and statistical information.
- **Cross-platform**: Supports Windows, macOS, and Linux.

## System Architecture

Website Push Data → Direct WebSocket Consumer (Backend) → Matching Engine (T0/T1/CHANGE_IMAGE) → Telegram (Sigma Bot)

## File Structure

v4/
├── chrome_extension/           # Chrome extension files
│   ├── manifest.json          # Extension manifest
│   ├── content.js             # Content script (DOM monitoring)
│   ├── injected.js            # Page injection script
│   ├── background.js          # Background service worker
│   ├── popup.html             # Extension popup interface
│   ├── popup.js               # Popup interaction logic
│   └── icons/                 # Extension icon directory
├── terminal_server.py          # Terminal broadcast service
├── requirements.txt            # Python dependencies
├── token_mapping.json          # Keyword mapping table
└── README.md                  # Instructions for use

## Quick Start

### 1. Environment Preparation

- Ensure Python 3.8+ is installed.
- 可选:Chrome 仅用于 UI,不影响核心功能。

**跨平台兼容性检查:**
```bash
# 运行兼容性检查(推荐首次运行前执行)
python platform_check.py
```

### 2. Install Python Dependencies

cd v4
pip install -r requirements.txt

### 3. Configure Keyword Mapping

Edit the `token_mapping.json` file.

### 4. Start Terminal Service

**Windows:**
```cmd
start_monitor.bat
# 或直接运行: python terminal_server.py
```

**macOS/Linux:**
```bash
./start_monitor.sh
# 或直接运行: python3 terminal_server.py
```

### 5. (Optional) Install Chrome Extension

1. Open Chrome browser.
2. Visit `chrome://extensions/`.
3. Enable "Developer mode" in the top right corner.
4. Click "Load unpacked".
5. Select the `v4/chrome_extension` directory.

### 6. Configure Source

编辑 `config.ini` 增加 `[Source] ws_url`,例如:

```
[Source]
ws_url = wss://x1.apidance.pro/userWs?uuid=YOUR_UUID
```

1. Visit `https://6551.io/twitterMonitor` in Chrome.
2. Complete any human verification on the site.
3. Click the extension icon in the Chrome toolbar.
4. Click "Start Monitoring" in the popup.

## Monitoring Mechanism

后端直连新源:
- WebSocket 长连,自动重连/心跳
- 解析 `msg_type` 与 `payload`,支持 `new_tweet/update_tweet/pin/follow/new_description/new_avatar` 等
- **权限控制**:T0_KEYS 只能由 T0_users 触发;T1_KEYS 可由 T0_users 或 T1_users 触发
- **推文类型**:支持交互内容三重检查(用户评论+被评论内容+被评论用户名)
- **follow 类型**:检查被关注用户 `screen_name`,遵循权限控制
- **new_description**:非空新值匹配关键字;空值时用 `screen_name.upper()` 匹配 `CHANGE_IMAGE`
- **new_avatar**:检查用户 `screen_name.upper()` 是否匹配 `CHANGE_IMAGE`

## API Endpoints

The terminal service provides the following HTTP API:

| Endpoint         | Method | Function                  |
|------------------|--------|---------------------------|
| /                | GET    | Service status and stats  |
| /health          | GET    | Health check              |
| /reload_config   | GET    | Reload config files       |
| /ws              | WS     | (兼容) 旧插件调试通道      |

## Troubleshooting

### Common Issues

- **Terminal service fails to start**: Check if the port is occupied or if dependencies are missing.
- **WS 未连接**:检查 `config.ini:[Source] ws_url` 是否配置正确,终端日志有连接状态。
- **No monitoring response**: Ensure you are on the correct website and check the browser console for logs.

### Platform-Specific Issues

**Windows:**
- **中文乱码**: 确保使用 Windows Terminal 或在命令提示符中运行 `chcp 65001`
- **Python 命令不可用**: 尝试使用 `py` 命令替代 `python`
- **权限问题**: 以管理员身份运行命令提示符

**macOS:**
- **权限问题**: 运行 `chmod +x start_monitor.sh` 添加执行权限
- **Python 版本**: 确保使用 `python3` 命令

**Linux:**
- **依赖缺失**: 运行 `sudo apt update && sudo apt install python3-pip`
- **权限问题**: 使用 `chmod +x *.sh` 添加脚本执行权限

## Security Notice

- This tool is for monitoring public content only.
- Ensure the accuracy of token addresses to avoid financial loss.
- It is recommended to test in a non-production environment before official use.

## License

This project is for learning and research purposes only. Users assume all risks associated with its use.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "memecoin-analyst-agent",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "mcp, agent, memecoin, bsc, web3, analysis",
    "author": "Memecoin Trading Team",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/fa/a3/3fbb527029cde84a3fbd652f5fd27b22892dbdc9ed52a72527e0ed874fa1/memecoin_analyst_agent-0.1.9.tar.gz",
    "platform": null,
    "description": "# 6551 Monitor Assistant v5.3\n\n\u540e\u7aef\u76f4\u8fde\u65b0\u7f51\u7ad9\u4e13\u5c5e WebSocket \u6e90\uff0c\u5b9e\u65f6\u6d88\u8d39\u63a8\u9001\uff0c\u8fdb\u884c\u7528\u6237/\u5173\u952e\u8bcd\u5339\u914d\u5e76\u5c06\u547d\u4e2d\u7684\u4ee3\u5e01\u5730\u5740\u53d1\u9001\u5230 Sigma Bot\u3002Chrome \u63d2\u4ef6\u4e0d\u518d\u5fc5\u987b\uff0c\u53ea\u4fdd\u7559\u4e3a\u53ef\u9009 UI\u3002\n\n**\ud83c\udf10 \u8de8\u5e73\u53f0\u652f\u6301\uff1a\u5b8c\u5168\u517c\u5bb9 Windows\u3001macOS \u548c Linux \u7cfb\u7edf**\n\n## Core Features\n\n- **Real-time Monitoring**: Multiple DOM monitoring strategies to ensure no content is missed.\n- **Intelligent Matching**: Case-insensitive keyword matching with a customizable mapping table.\n- **Terminal Broadcasting**: Color-coded terminal output with sound alerts.\n- **Desktop Notifications**: Native Chrome notification system.\n- **Real-time Statistics**: Match history and statistical information.\n- **Cross-platform**: Supports Windows, macOS, and Linux.\n\n## System Architecture\n\nWebsite Push Data \u2192 Direct WebSocket Consumer (Backend) \u2192 Matching Engine (T0/T1/CHANGE_IMAGE) \u2192 Telegram (Sigma Bot)\n\n## File Structure\n\nv4/\n\u251c\u2500\u2500 chrome_extension/           # Chrome extension files\n\u2502   \u251c\u2500\u2500 manifest.json          # Extension manifest\n\u2502   \u251c\u2500\u2500 content.js             # Content script (DOM monitoring)\n\u2502   \u251c\u2500\u2500 injected.js            # Page injection script\n\u2502   \u251c\u2500\u2500 background.js          # Background service worker\n\u2502   \u251c\u2500\u2500 popup.html             # Extension popup interface\n\u2502   \u251c\u2500\u2500 popup.js               # Popup interaction logic\n\u2502   \u2514\u2500\u2500 icons/                 # Extension icon directory\n\u251c\u2500\u2500 terminal_server.py          # Terminal broadcast service\n\u251c\u2500\u2500 requirements.txt            # Python dependencies\n\u251c\u2500\u2500 token_mapping.json          # Keyword mapping table\n\u2514\u2500\u2500 README.md                  # Instructions for use\n\n## Quick Start\n\n### 1. Environment Preparation\n\n- Ensure Python 3.8+ is installed.\n- \u53ef\u9009\uff1aChrome \u4ec5\u7528\u4e8e UI\uff0c\u4e0d\u5f71\u54cd\u6838\u5fc3\u529f\u80fd\u3002\n\n**\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\u68c0\u67e5\uff1a**\n```bash\n# \u8fd0\u884c\u517c\u5bb9\u6027\u68c0\u67e5\uff08\u63a8\u8350\u9996\u6b21\u8fd0\u884c\u524d\u6267\u884c\uff09\npython platform_check.py\n```\n\n### 2. Install Python Dependencies\n\ncd v4\npip install -r requirements.txt\n\n### 3. Configure Keyword Mapping\n\nEdit the `token_mapping.json` file.\n\n### 4. Start Terminal Service\n\n**Windows:**\n```cmd\nstart_monitor.bat\n# \u6216\u76f4\u63a5\u8fd0\u884c: python terminal_server.py\n```\n\n**macOS/Linux:**\n```bash\n./start_monitor.sh\n# \u6216\u76f4\u63a5\u8fd0\u884c: python3 terminal_server.py\n```\n\n### 5. (Optional) Install Chrome Extension\n\n1. Open Chrome browser.\n2. Visit `chrome://extensions/`.\n3. Enable \"Developer mode\" in the top right corner.\n4. Click \"Load unpacked\".\n5. Select the `v4/chrome_extension` directory.\n\n### 6. Configure Source\n\n\u7f16\u8f91 `config.ini` \u589e\u52a0 `[Source] ws_url`\uff0c\u4f8b\u5982\uff1a\n\n```\n[Source]\nws_url = wss://x1.apidance.pro/userWs?uuid=YOUR_UUID\n```\n\n1. Visit `https://6551.io/twitterMonitor` in Chrome.\n2. Complete any human verification on the site.\n3. Click the extension icon in the Chrome toolbar.\n4. Click \"Start Monitoring\" in the popup.\n\n## Monitoring Mechanism\n\n\u540e\u7aef\u76f4\u8fde\u65b0\u6e90\uff1a\n- WebSocket \u957f\u8fde\uff0c\u81ea\u52a8\u91cd\u8fde/\u5fc3\u8df3\n- \u89e3\u6790 `msg_type` \u4e0e `payload`\uff0c\u652f\u6301 `new_tweet/update_tweet/pin/follow/new_description/new_avatar` \u7b49\n- **\u6743\u9650\u63a7\u5236**\uff1aT0_KEYS \u53ea\u80fd\u7531 T0_users \u89e6\u53d1\uff1bT1_KEYS \u53ef\u7531 T0_users \u6216 T1_users \u89e6\u53d1\n- **\u63a8\u6587\u7c7b\u578b**\uff1a\u652f\u6301\u4ea4\u4e92\u5185\u5bb9\u4e09\u91cd\u68c0\u67e5\uff08\u7528\u6237\u8bc4\u8bba+\u88ab\u8bc4\u8bba\u5185\u5bb9+\u88ab\u8bc4\u8bba\u7528\u6237\u540d\uff09\n- **follow \u7c7b\u578b**\uff1a\u68c0\u67e5\u88ab\u5173\u6ce8\u7528\u6237 `screen_name`\uff0c\u9075\u5faa\u6743\u9650\u63a7\u5236\n- **new_description**\uff1a\u975e\u7a7a\u65b0\u503c\u5339\u914d\u5173\u952e\u5b57\uff1b\u7a7a\u503c\u65f6\u7528 `screen_name.upper()` \u5339\u914d `CHANGE_IMAGE`\n- **new_avatar**\uff1a\u68c0\u67e5\u7528\u6237 `screen_name.upper()` \u662f\u5426\u5339\u914d `CHANGE_IMAGE`\n\n## API Endpoints\n\nThe terminal service provides the following HTTP API:\n\n| Endpoint         | Method | Function                  |\n|------------------|--------|---------------------------|\n| /                | GET    | Service status and stats  |\n| /health          | GET    | Health check              |\n| /reload_config   | GET    | Reload config files       |\n| /ws              | WS     | (\u517c\u5bb9) \u65e7\u63d2\u4ef6\u8c03\u8bd5\u901a\u9053      |\n\n## Troubleshooting\n\n### Common Issues\n\n- **Terminal service fails to start**: Check if the port is occupied or if dependencies are missing.\n- **WS \u672a\u8fde\u63a5**\uff1a\u68c0\u67e5 `config.ini:[Source] ws_url` \u662f\u5426\u914d\u7f6e\u6b63\u786e\uff0c\u7ec8\u7aef\u65e5\u5fd7\u6709\u8fde\u63a5\u72b6\u6001\u3002\n- **No monitoring response**: Ensure you are on the correct website and check the browser console for logs.\n\n### Platform-Specific Issues\n\n**Windows:**\n- **\u4e2d\u6587\u4e71\u7801**: \u786e\u4fdd\u4f7f\u7528 Windows Terminal \u6216\u5728\u547d\u4ee4\u63d0\u793a\u7b26\u4e2d\u8fd0\u884c `chcp 65001`\n- **Python \u547d\u4ee4\u4e0d\u53ef\u7528**: \u5c1d\u8bd5\u4f7f\u7528 `py` \u547d\u4ee4\u66ff\u4ee3 `python`\n- **\u6743\u9650\u95ee\u9898**: \u4ee5\u7ba1\u7406\u5458\u8eab\u4efd\u8fd0\u884c\u547d\u4ee4\u63d0\u793a\u7b26\n\n**macOS:**\n- **\u6743\u9650\u95ee\u9898**: \u8fd0\u884c `chmod +x start_monitor.sh` \u6dfb\u52a0\u6267\u884c\u6743\u9650\n- **Python \u7248\u672c**: \u786e\u4fdd\u4f7f\u7528 `python3` \u547d\u4ee4\n\n**Linux:**\n- **\u4f9d\u8d56\u7f3a\u5931**: \u8fd0\u884c `sudo apt update && sudo apt install python3-pip`\n- **\u6743\u9650\u95ee\u9898**: \u4f7f\u7528 `chmod +x *.sh` \u6dfb\u52a0\u811a\u672c\u6267\u884c\u6743\u9650\n\n## Security Notice\n\n- This tool is for monitoring public content only.\n- Ensure the accuracy of token addresses to avoid financial loss.\n- It is recommended to test in a non-production environment before official use.\n\n## License\n\nThis project is for learning and research purposes only. Users assume all risks associated with its use.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Memecoin Smart Trading Analyst Agent with MCP server for Alibaba Cloud Bailian",
    "version": "0.1.9",
    "project_urls": {
        "Homepage": "https://github.com/memecoin-trading/agent"
    },
    "split_keywords": [
        "mcp",
        " agent",
        " memecoin",
        " bsc",
        " web3",
        " analysis"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "43cb9d97bb27e85c74b2bd289d67b55df469f70875013036df3e10a4dfdb4308",
                "md5": "1782ac040d89dd91f78a929fbce83af1",
                "sha256": "7c4453068daf990b7711111107ce9e8bdc92aeb7b4825d5e3f720ab394f1de58"
            },
            "downloads": -1,
            "filename": "memecoin_analyst_agent-0.1.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1782ac040d89dd91f78a929fbce83af1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 90610,
            "upload_time": "2025-09-02T11:37:11",
            "upload_time_iso_8601": "2025-09-02T11:37:11.676097Z",
            "url": "https://files.pythonhosted.org/packages/43/cb/9d97bb27e85c74b2bd289d67b55df469f70875013036df3e10a4dfdb4308/memecoin_analyst_agent-0.1.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "faa33fbb527029cde84a3fbd652f5fd27b22892dbdc9ed52a72527e0ed874fa1",
                "md5": "6c2c766483dd867d3f0c02992deaf961",
                "sha256": "3fc5e6daa579fd7059dbf180e904f4068d707ce1fc0ec3ed56a70224453bc0c9"
            },
            "downloads": -1,
            "filename": "memecoin_analyst_agent-0.1.9.tar.gz",
            "has_sig": false,
            "md5_digest": "6c2c766483dd867d3f0c02992deaf961",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 72618,
            "upload_time": "2025-09-02T11:37:14",
            "upload_time_iso_8601": "2025-09-02T11:37:14.740439Z",
            "url": "https://files.pythonhosted.org/packages/fa/a3/3fbb527029cde84a3fbd652f5fd27b22892dbdc9ed52a72527e0ed874fa1/memecoin_analyst_agent-0.1.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-02 11:37:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "memecoin-trading",
    "github_project": "agent",
    "github_not_found": true,
    "lcname": "memecoin-analyst-agent"
}
        
Elapsed time: 1.62507s