Progressive disclosure

Install the skill

Copy the skill folder into the skills directory of your host, keeping the folder name exactly pytse-client. Then install the runtime in the environment where the agent executes scripts: pip install pytse-client.

Claude Code

~/.claude/skills/pytse-client/

or .claude/skills/pytse-client/ inside a project

Cursor

.cursor/skills/pytse-client/

project-local; restart the agent after copy

Codex / agentskills hosts

~/.agents/skills/pytse-client/

directory name must match the SKILL.md name field

Gemini CLI

~/.gemini/skills/pytse-client/

same SKILL.md open standard

Shell

# 1) clone this repo
git clone https://github.com/MiladAghdak/pytse-client-skill.git
# 2) copy the skill folder into your host's skills directory
cp -r pytse-client-skill/public/skills/pytse-client ~/.claude/skills/pytse-client
# 3) install the Python library the scripts import
pip install pytse-client

Files in the package

SKILL.mdYAML frontmatter + activation rules, decision tree, hard constraints.
LICENSEGPL-3.0 notice — the skill wraps the GPLv3 pytse-client upstream.
references/ticker-api.mdEvery Ticker property, realtime board, shareholders, float, trade ticks.
references/download-api.mdBatch history, adjust=True algorithm, CSV layout, jdate.
references/orderbook-and-trades.mdget_orderbook, get_trade_details, timeframes, diff_orderbook.
references/financial-indexes.mdشاخص کل and sector indexes, FinancialIndex class, intraday.
references/filter-stats.mdget_stats, market watch, flow codes, YVal instrument types.
references/pitfalls.mdIP bans, asyncio, Arabic/Persian letters, halted symbols, missing EPS.
references/symbols-and-markets.mdFlow codes, ISIN, delisted index override, all_symbols().
references/agent-protocol.mdJSON tool schemas, HTTP invoke contract, progressive disclosure.
references/data-dictionary.mdExact columns, dtypes, and CSV/cache conventions for every DataFrame pytse-client returns.
scripts/_jsonio.pyPrivate helpers shared by the bundled scripts: JSON output, error envelopes, frame normalization.
scripts/download_history.pyCLI: download OHLCV for one or all symbols as JSON.
scripts/ticker_snapshot.pyCLI: fundamentals + last board for one symbol.
scripts/client_types.pyCLI: حقیقی/حقوقی history.
scripts/financial_index.pyCLI: index snapshot + history.
scripts/get_orderbook.pyCLI: historical five-level book.
scripts/get_trade_details.pyCLI: ticks or aggregated intraday bars.
scripts/get_stats.pyCLI: key stats universe for filter writing.
scripts/resolve_symbol.pyCLI: search TSETMC and normalize Arabic/Persian letters.
scripts/smoke.pyOffline runtime self-test: imports, symbols corpus, known-symbol resolution.
assets/tools.jsonMachine-readable tool catalog matching this studio.

GET /api/skill

Machine catalog for hosts that fetch over HTTP.

GET /api/skill/md

Raw SKILL.md, regenerated from the served skill.

GET /api/mcp/tools

MCP-shaped tool list with JSON Schema.