https://github.com/leeguooooo/paypay-securities
Read-only CLI & agent skill for a PayPay証券 (PayPay Securities / ペイペイ証券) account — portfolio, holdings, 投資信託/米国株, transaction history, fee & FX-spread analysis, and a review (復盘) with P&L + risk checks. npx skills add.
https://github.com/leeguooooo/paypay-securities
agent-skill claude-code claude-skill cli fintech investment japan nisa paypay paypay-securities portfolio python skills-sh stock-portfolio
Last synced: 4 days ago
JSON representation
Read-only CLI & agent skill for a PayPay証券 (PayPay Securities / ペイペイ証券) account — portfolio, holdings, 投資信託/米国株, transaction history, fee & FX-spread analysis, and a review (復盘) with P&L + risk checks. npx skills add.
- Host: GitHub
- URL: https://github.com/leeguooooo/paypay-securities
- Owner: leeguooooo
- Created: 2026-05-29T06:46:58.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-29T08:14:54.000Z (about 1 month ago)
- Last Synced: 2026-05-29T08:31:53.141Z (about 1 month ago)
- Topics: agent-skill, claude-code, claude-skill, cli, fintech, investment, japan, nisa, paypay, paypay-securities, portfolio, python, skills-sh, stock-portfolio
- Language: Python
- Size: 55.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
Awesome Lists containing this project
README
# paypay-securities
[日本語](README.md) | **English**
A read-only command-line client for a **PayPay証券 (PayPay Securities, ペイペイ証券)**
account — balance, holdings, mutual funds (投資信託), US stocks (米国株), transaction
history, a measured cost analysis (incl. the FX spread PayPay never itemizes), and
a portfolio **review** with realized/unrealized P&L. Great for NISA and routine
investment review. Data display only — no advice. Distributed as an
[agent skill](https://skills.sh) and usable as a plain CLI.
> Read-only: it never places or cancels orders. Use on your own account at your
> own risk — automated access may conflict with PayPay証券's terms of service.
## Install
```bash
npx skills add leeguooooo/paypay-securities --skill paypay-securities # project-local
npx skills add leeguooooo/paypay-securities --skill paypay-securities -g # user-global (~/.claude/skills/)
```
This installs the `paypay-securities` skill (SKILL.md + the bundled Python CLI) into your
agent's skills directory. Requires [`uv`](https://docs.astral.sh/uv/).
## Configure
Put credentials in `~/.paypay-sec/.env` (see
[`skills/paypay-securities/.env.example`](skills/paypay-securities/.env.example)):
```
PAYPAY_MEMBER_ID=Pxxxxxxxxx
PAYPAY_PASSWORD=...
PAYPAY_COOKIE=... # full Cookie header incl. the ..._SMS_AUTH_STRING device token
```
**Multiple accounts:** the default account reads `~/.paypay-sec/.env`; a named
account `` reads `~/.paypay-sec/.env`. Switch with `-a ` (or
`PAYPAY_ACCOUNT`): `uv run paypay assets -a second`. Each account keeps its own
session + cache. `uv run paypay accounts` lists them.
## Use
```bash
cd skills/paypay-securities
uv run paypay assets # consolidated holdings + cash + grand total
uv run paypay review # review: assets, realized/unrealized P&L, deposits, costs, holdings
uv run paypay review --format lark # Feishu/Lark-friendly bullets
uv run paypay trades-summary # per-brand buy/sell/net-invested/realized P&L
uv run paypay fees # cost analysis (explicit fees + measured FX spread)
```
Run from anywhere (no `cd`): put the launcher on PATH —
`ln -s "$HOME/.claude/skills/paypay-securities/bin/paypay" ~/.local/bin/paypay`
→ `paypay review --format lark`.
Full command reference and architecture notes: [`skills/paypay-securities/SKILL.md`](skills/paypay-securities/SKILL.md).
## Repository layout
```
skills/paypay-securities/ the shippable skill (SKILL.md + paypay_sec/ CLI + pyproject.toml)
tests/ dev tests (fixtures hold real account data → gitignored)
```