360 Secure SkillHub
360 安全技能中心

Yandex 360 CLI (Disk, Calendar, Mail)

yax 是一个 Node 命令行工具，通过 Yandex OAuth 授权访问 Yandex 服务：可查询磁盘信息、列目录、新建文件夹、上传下载文件，并通过 CalDAV 列出日历与创建带时区的事件；邮件部分仅提供说明，因无公开邮件 HTTP API，仅支持 IMAP/SMTP 且云环境端口常被封锁。

smvlx
smvlx
热度 61.92
最近更新 2026-05-11 17:29:11
分类：自动化依赖：代码执行 / 读写文件 / 第三方 API应用场景：工作流 / 日程安排 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add yandex-cli-yax
Metadata
name
yax
description
CLI tool for Yandex Disk, Calendar, and Mail via Yandex OAuth API
version
1.1.0
metadata
{"openclaw":{"emoji":"📁","homepage":"https://github.com/smvlx/openclaw-ru-skills","os":["darwin","linux"],"requires":{"bins":["node"],"env":["YAX_CLIENT_ID"]},"primaryEnv":"YAX_CLIENT_ID","configPaths":["~/.openclaw/yax.env","~/.openclaw/yax-token.json"]}}

yax — Yandex 360 CLI

CLI tool for Yandex Disk, Calendar, and Mail via Yandex OAuth API.

Features

  • Disk: info, list, mkdir, upload, download
  • Calendar: list calendars, create events (via CalDAV)
  • Mail: ⚠️ Limited — Yandex has no public HTTP API for mail (IMAP/SMTP only, ports often blocked in cloud)

Prerequisites

  1. Create a Yandex OAuth app at https://oauth.yandex.ru/client/new

    • Redirect URI: https://oauth.yandex.ru/verification_code
    • Required scopes:
      • cloud_api:disk.app_folder — Disk app folder access
      • cloud_api:disk.info — Disk info
      • calendar:all — Calendar read/write
      • mail:smtp — Mail sending (SMTP only, no HTTP API)
    • Note the Client ID and Client Secret

  2. Save config to ~/.openclaw/yax.env:

    YAX_CLIENT_ID=your_app_client_id
YAX_CLIENT_SECRET=your_app_secret_if_any

Setup & Auth

scripts/setup.sh        # Create env template
node src/yax.cjs auth   # OAuth flow (opens browser URL, paste code)

Usage

# Disk
node src/yax.cjs disk info
node src/yax.cjs disk list /
node src/yax.cjs disk mkdir /test-folder
node src/yax.cjs disk upload ./local-file.txt /remote-path.txt
node src/yax.cjs disk download /remote-path.txt ./local-file.txt

# Calendar
node src/yax.cjs calendar list
node src/yax.cjs calendar create "Meeting" "2026-02-14" "11:00:00" "12:00:00" "Holiday meeting" "Europe/Moscow"

# Mail (informational only)
node src/yax.cjs mail

Implementation Details

  • Calendar: Uses raw CalDAV HTTP requests to caldav.yandex.ru. Automatically discovers user login via OAuth info endpoint and calendar paths via PROPFIND. Supports timezone-aware event creation. No external dependencies.
  • Mail: Yandex does not offer a public REST/HTTP API for mail operations. Only IMAP/SMTP is available, which requires direct TCP connections on ports 993/465 — typically blocked in cloud environments (Railway, etc.). The Yandex 360 Admin API exists for organization accounts but is not suitable for personal use.

Scripts

  • scripts/setup.sh — Create env template
  • scripts/start.sh — N/A (CLI tool, not a daemon)
  • scripts/stop.sh — N/A
  • scripts/status.sh — Check auth status