CLI自动化框架

Explore web workflow (requires LLM)

cliany-site explore "https://github.com" "Search and view results" --json

Fail fast if all rows are empty or required fields are blank

cliany-site browser extract \ --selector ".result-card" \ --mode list \ --fields-json '{"title": ".title", "url": "a@href"}' \ --strict-quality \ --json ```

Structured extraction responses include data.quality. Generated list- and search- adapter commands also include that summary and return E_EMPTY_RESULT when extraction quality is empty or partially missing required fields, so automation can distinguish "command ran" from "useful data was found".

Installation

```bash

Install via PyPI

pip install cliany-site

Or install from source

git clone https://github.com/pearjelly/cliany.site.git cd cliany.site pip install -e . ```

1. Install Obscura binary (version >= 0.1.0)

cliany-site obscura install 0.1.0 --json

1. Install adapter

cliany-site market install ./demo.suiteondemand.com.cliany-adapter-v0.14.0.tar.gz

ASF Jenkins (Build Status)

cliany-site market install ./builds.apache.org.cliany-adapter-v0.14.0.tar.gz
cliany-site builds.apache.org list-jobs --json

Disclaimer: These demo sites are operated by third parties and may be temporarily unavailable. cliany-site only provides the CLI shim; we do not control the demo data or uptime.

Install adapter

cliany-site market install ~/.cliany-site/packages/github.com-1.0.0.cliany-adapter.tar.gz

Quick Start (v0.11.0+)

For a guided first run, see 10-minute success path. It starts with a real demo adapter before requiring LLM setup, then points successful users toward the Real Demo Case Proposal path for contributing new public read-only cases.

Usage Examples

Discover maintained real demo cases

cliany-site cases --json cliany-site cases --status candidate --promotion-plan cliany-site cases --json --status candidate --promotion-plan cliany-site cases --case-id pypi-project-search --json cliany-site cases --case-id pypi-project-search --issue-template cliany-site cases --case-id pypi-project-search --evidence-bundle cliany-site cases --case-id pypi-project-search --evidence-bundle --json

Try Real Demos

The following adapters are available as downloadable assets on GitHub Release v0.14.1. The maintained case index lives in cases/README.md and cases/manifest.json. Use cliany-site cases --json to inspect active demos, candidate workflows, offline validation commands, and candidate promotion next actions from the CLI; promotion_evidence_summary.primary_next_task points automation at the first candidate task to advance, while promotion_evidence_summary.primary_next_task_acceptance_criteria states the proof required for that task. Add --promotion-plan to print the candidate promotion queue across all matched candidates; combine it with --json to read promotion_plan.primary_next_item, per-candidate primary tasks, and the incomplete task_queue. Use cliany-site cases --case-id pypi-project-search --json to open one case with validation and promotion details; omit --json for a copy-friendly human handoff with Promotion Tasks. Add --issue-template to print a GitHub issue body for a candidate promotion task, including Acceptance Criteria for each evidence task; combine it with --json to also read issue_template_primary_task without parsing Markdown. Add --evidence-bundle to print a structured local evidence checklist; combine it with --json for a machine-readable evidence bundle, including a promotion_command_plan that starts with llm_live_preflight before adapter package, metadata validation, and online smoke commands, plus acceptance_criteria for the proof each evidence task must attach. Use python scripts/plan_next_iteration.py --issues-dir /tmp/cliany-candidate-issues to generate reviewable candidate issue artifacts; the artifacts README shows Primary Evidence Status, Primary Acceptance Criteria, and primary_next_task_acceptance_criteria before maintainers create issues.

SuiteCRM Demo (Enterprise CRM)

```bash

2. Login (opens browser — use demo account from https://demo.suiteondemand.com/)

cliany-site login https://demo.suiteondemand.com/

Check environment

cliany-site doctor --json

Optional live provider preflight before explore

cliany-site doctor --llm-live --json

Configuration

```bash

Verify Environment

cliany-site doctor --json
cliany-site doctor --llm-live --json

By default, doctor checks local configuration, CDP, directories, and keys without calling the LLM provider. Add --llm-live when you want a real provider preflight before a longer explore; retryable gateway, rate-limit, or service outages appear as a llm_live warning with details.error_code=E_LLM_UNAVAILABLE.

Python SDK

from cliany_site.sdk import ClanySite

async with ClanySite() as cs:
    result = await cs.explore("https://github.com", "搜索仓库")
    adapters = await cs.list_adapters()

HTTP API

```bash

Call API

curl http://localhost:8080/doctor curl http://localhost:8080/adapters curl -X POST http://localhost:8080/explore \ -H "Content-Type: application/json" \ -d '{"url": "https://github.com", "workflow": "搜索仓库"}' ```

Command Reference

Global Options: --json --verbose --debug --cdp-url <ws://host:port> --headless --sandbox --explain --force-browser --diagnose

Ecosystem Integration

• Python SDK — from cliany_site import explore, execute for programmatic calls.
• HTTP API — cliany-site serve --port 8080 starts a REST API service.
• Adapter Marketplace — Pack, install, uninstall, and rollback adapters to share automation capabilities within teams.
• TUI Management Interface — A Textual-based terminal UI for visual adapter management.
• iframe/Shadow DOM — Recursive AXTree collection with cross-origin iframe and Shadow DOM penetration.

Basic Workflow

```bash

1. Explore workflow

cliany-site explore "https://github.com" "Search repository and view README" --json

YAML Workflow Orchestration

```yaml

workflow.yaml

name: GitHub Search Process steps: - name: Search Repository adapter: github.com command: search params: query: "cliany-site" - name: View Details adapter: github.com command: view params: repo: "$prev.data.results[0].name"