mcpField
L
lunarcrush

lunarcrush

github.com/starchild-ai-agent数据与数据库30266 次安装6 天前更新
代码仓库

关于 lunarcrush

lunarcrush 是用于查询 LunarCrush 加密资产社交情绪与热度数据的脚本技能,面向分析币种、话题及创作者动态的用户。它提供当前指标、历史序列、话题帖子和创作者数据查询。

主要功能

  1. 01查询币种社交指标与价格信息
  2. 02获取历史社交数据序列
  3. 03查询币种元数据
  4. 04分析话题指标及近期帖子
  5. 05查看创作者与影响者数据

适用场景

  1. 01比较 BTC、ETH 等币种的社交热度
  2. 02结合历史数据观察情绪变化
  3. 03发现热门话题并查看相关帖子
  4. 04跟踪指定社交平台创作者

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill lunarcrush

安装后在 Claude Code 中输入/lunarcrush确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

__init__.py
exports.py
lunarcrush.py
tools/
__init__.py
coins.py
creators.py
nfts.py
topics.py
utils.py

详细介绍

脚本用法

脚本模式技能——读取此文件,然后从 bash 代码块中调用:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/lunarcrush")
from exports import lunar_coin, lunar_coin_time_series, lunar_topic

# BTC social metrics
btc = lunar_coin(coin="BTC")
print(json.dumps(btc, indent=2))

# 30-day BTC galaxy_score timeseries
ts = lunar_coin_time_series(coin="BTC", bucket="day", interval="1m")
print(json.dumps(ts.get("data", [])[:3], indent=2))
EOF

exports.py 中的可用函数:lunar_coin、lunar_coin_time_series、 lunar_coin_meta、lunar_topic、lunar_topic_posts、lunar_creator。 直接阅读 exports.py 以查看确切的签名。

LunarCrush

LunarCrush 提供社交智能和情绪数据,包括 Galaxy Score、AltRank、社交声量、影响者活动和热门话题。这是反映大众情绪的维度。

函数参考(签名)

所有函数都位于 exports.py 中。币种代码使用大写字母(BTC、 ETH、SOL)。

函数描述
lunar_coin(coin)当前社交指标:galaxy_score、alt_rank、social_volume、social_dominance、价格、market_cap。返回字典(不封装在 {data: ...} 中)。
lunar_coin_time_series(coin, bucket='day', interval='1m')历史时间序列。bucket = hour/day/week。interval = 1d/1w/1m/3m/6m/1y。
lunar_coin_meta(coin)币种元数据(描述、链接、类别)。
lunar_topic(topic)某个话题/关键词(例如 bitcoin、defi)的社交指标。
lunar_topic_posts(topic, limit=20)提及该话题的近期帖子,按互动量排序。
lunar_creator(network, id)创作者/影响者数据。network = twitter / youtube / reddit / tiktok。id = 不带 @ 的用户名。

何时使用 LunarCrush

以下情况可使用 LunarCrush:

  • 社交情绪 - 大众在说什么?
  • Galaxy Score - 整体社交势头(0-100)
  • AltRank - 社交排名(越低越好)
  • 社交声量 - 社交提及次数
  • 影响者活动 - 重要声音在说什么?
  • 热门话题 - 什么正在获得关注?

常见工作流

币种社交数据
lunar_coin(symbol="BTC")  # Current social metrics
lunar_coin(symbol="ETH")  # Ethereum social data
lunar_coin_time_series(symbol="SOL", interval="1d", bucket="day")  # Historical
lunar_coin_meta(symbol="BTC")  # Metadata and links
话题分析
lunar_topic(topic="defi")  # DeFi topic metrics
lunar_topic_posts(topic="nft")  # Recent posts about NFTs
创作者/影响者
lunar_creator(creator_id="123456")  # Specific influencer data

关键指标

Galaxy Score(0-100)
分数解读
80–100社交势头极强——留意市场高点
60–79兴趣持续强劲
40–59活动正常
20–39兴趣减弱
0–19热度消退或正在触底

背离信号:Galaxy Score 高且价格下跌 = 可能出现反转。

AltRank

越低越好。排名 #1–50 属于社交影响力顶尖梯队。可用于在价格变动前发现正在获得关注的山寨币。

  • 排名 1-10:社交关注度最高
  • 排名 11-50:社交影响力强
  • 排名 51-100:关注度中等
  • 排名 100+:社交关注度低
社交声量

各个平台(Twitter、Reddit 等)的社交提及次数。社交声量上升往往先于价格变动。

社交主导度

占加密货币社交总声量的百分比。主导度高意味着该币种在加密货币讨论中占据主导地位。

分析模式

社交 Alpha:Galaxy Score 上升且价格持平 = 可能形成突破形态。社交关注度在价格变动前开始积聚。

背离信号:

  • Galaxy Score 高且价格下跌 = 看跌背离
  • Galaxy Score 低且价格上涨 = 涨势疲弱

情绪确认:结合 Galaxy Score、社交声量和 AltRank。三者同向变动 = 强信号。

追踪影响者:通过创作者工具监测重要声音的言论。影响者的关注可能带动散户兴趣。

时间间隔

  • 1h - 每小时
  • 1d - 每日
  • 1w - 每周

重要说明

  • API 密钥:需要设置 LUNARCRUSH_API_KEY 环境变量
  • 币种代码:使用标准代码(BTC、ETH、SOL 等)
  • 社交平台:数据汇总自 Twitter、Reddit、Medium、YouTube 等平台
  • 实时性:社交指标近乎实时更新
  • 领先指标:社交数据通常领先于价格——关注度会在价格变动前积聚

工作流示例

寻找正在走强的币种
  1. 使用 lunar_coin 查看 AltRank 和 Galaxy Score
  2. 寻找 AltRank 不断上升(数值越低越好)且 Galaxy Score > 60 的币种
  3. 查看价格是否持平或上涨——社交关注度升温是领先信号
情绪检查
  1. 获取当前 Galaxy Score 和社交声量
  2. 通过 lunar_coin_time_series 与历史数据进行比较
  3. 高分 + 声量上升 = 强劲势头
  4. 低分 + 声量下降 = 关注度低
话题趋势
  1. 使用 lunar_topic 查找热门话题(DeFi、NFT、Gaming 等)
  2. 使用 lunar_topic_posts 查看大家在讨论什么
  3. 与价格走势交叉参考,寻找趋势早期信号

评论

支持 Markdown