# Macos Suite Readonly

> macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。

- Skill: `dvcrn/macos-suite-readonly` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/macos-suite-readonly`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/macos-suite-readonly/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/macos-suite-readonly

---


# macos-suite-readonly

面向 ClawHub 的“只读”macOS 查询技能：读取邮件未读、日程、备忘录搜索、股票行情。所有命令输出单个 JSON，适合 agent 解析。

## ⚠️ 权限

- 首次调用可能弹出系统权限提示（自动化/隐私）。
- 若系统拒绝自动化权限，命令会返回 `ok=false` 或 `warning`。

## 使用方式

```bash
python3 {baseDir}/scripts/main.py <command> key=value key=value ...
```

## Commands

### Mail

```bash
python3 {baseDir}/scripts/main.py mail.unread_count
python3 {baseDir}/scripts/main.py mail.unread_list limit=20
```

### Calendar

```bash
python3 {baseDir}/scripts/main.py calendar.today limit=50
python3 {baseDir}/scripts/main.py calendar.list start="2026-03-03 00:00:00" end="2026-03-03 23:59:59" limit=50
```

### Notes

```bash
python3 {baseDir}/scripts/main.py notes.folders
python3 {baseDir}/scripts/main.py notes.search query="购物" limit=10 folder="Notes"
```

### Stocks

```bash
python3 {baseDir}/scripts/main.py stocks.quote symbol=AAPL
python3 {baseDir}/scripts/main.py stocks.quote symbol=600519
python3 {baseDir}/scripts/main.py stocks.batch symbols="AAPL,600519,00700"
```