convez.ai
SkillFinanceiroIntermediário
leeguooooo

PayPay Securities CLI & Agent Skill

leeguooooo/paypay-securities

Consulte portfólio PayPay Securities com análise de custos e P&L

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill read-only para visualizar portfólio, posições, fundos de investimento, ações americanas e histórico de transações da corretora PayPay Securities (plataforma japonesa). Inclui análise de custos (taxas e spread de câmbio) e revisão completa com P&L realizado e não realizado, sem capacidade de executar ordens.

Instalação

$npx convez-ai leeguooooo/paypay-securities

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 semanas
Versão
v0.2.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Revisar alocação de ativos e performance em NISA/contas de investimento
  • Analisar custos reais (taxas explícitas + spread de FX) por transação
  • Gerar relatórios de P&L realizado/não realizado para balanceamento de portfólio

Veredito

Ferramenta especializada e bem desenhada para investidores em plataforma PayPay Securities (mercado JP). Read-only é o padrão seguro. Requer autenticação manual e respeita ToS; muito útil para quem usa essa corretora, mas nicho específico.

README

A tradução para o português deste README ainda está na fila.

paypay-securities

日本語 | English

PayPay証券(ペイペイ証券 / PayPay Securities) 口座の残高・保有銘柄・投資信託・ 米国株・取引履歴を参照し、手数料や為替スプレッドのコストを実測、復盘(レビュー)まで 出力する読み取り専用のコマンドラインツールです。NISA や日々の投資振り返りに。 エージェントスキルとして配布され、通常の CLI としても使えます。

読み取り専用です。注文の発注・取消は一切行いません。ご自身の口座で自己責任の もとご利用ください。自動アクセスはPayPay証券の利用規約に抵触する可能性があります。

インストール

npx skills add leeguooooo/paypay-securities --skill paypay-securities       # プロジェクトに追加
npx skills add leeguooooo/paypay-securities --skill paypay-securities -g     # ユーザー全体 (~/.claude/skills/)

paypay-securities スキル(SKILL.md + 同梱の Python CLI)がエージェントのスキル ディレクトリに導入されます。uv が必要です。

設定

認証情報を ~/.paypay-sec/.env に置きます (skills/paypay-securities/.env.example 参照):

PAYPAY_MEMBER_ID=Pxxxxxxxxx
PAYPAY_PASSWORD=...
PAYPAY_COOKIE=...   # ログイン済みブラウザの Cookie ヘッダ全体(..._SMS_AUTH_STRING デバイストークンを含むこと)

複数アカウント: 既定アカウントは ~/.paypay-sec/.env、別名アカウント <name> は ~/.paypay-sec/<name>.env を読みます。-a <name>(または PAYPAY_ACCOUNT)で切り替え: uv run paypay assets -a second。アカウントごとにセッション・キャッシュは独立。 uv run paypay accounts で一覧表示。

使い方

cd skills/paypay-securities
uv run paypay assets               # 保有資産の総覧(保有銘柄 + 現金 + 総資産合計)
uv run paypay review               # 復盘: 資産・実現/未実現損益・入金・コスト・保有
uv run paypay review --format lark # Feishu/Lark 向けの箇条書き出力
uv run paypay trades-summary       # 銘柄別の買い/売り/純投入/実現損益
uv run paypay fees                 # コスト分析(明示手数料 + 実測の為替スプレッド)

どこからでも実行(cd 不要):ランチャーを PATH に通す — ln -s "$HOME/.claude/skills/paypay-securities/bin/paypay" ~/.local/bin/paypay → paypay review --format lark。

コマンド一覧と設計メモ: skills/paypay-securities/SKILL.md。

リポジトリ構成

skills/paypay-securities/     配布するスキル(SKILL.md + paypay_sec/ CLI + pyproject.toml)
tests/                        開発用テスト(フィクスチャに実口座データを含むため gitignore)
Ver o original no GitHub

Bom para

Relacionados