### FQL Filter Examples Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md Various examples demonstrating range queries, negation, regex matching, and specific field constraints. ```text (brand:"Nike" OR brand:"Adidas") AND (salePrice:["100" TO "500"]) AND (inStock:"true") ``` ```text (salePrice:{"1000" TO *]) AND (inStock:"true") ``` ```text (salePrice:{"100" TO "500"}) AND (brand:"Nike"#s) ``` ```text (dataSource.uid:"") AND (approval:"pending") ``` ```text (title:"*sleva*") AND (NOT title:"*výprodej*") ``` ```text title:{"70" TO *]#L ``` ```text sku:"~^AB[0-9]{4}$~"#s ``` ```text id:("101;102;103") ``` -------------------------------- ### Initialize Conviu Skills via CLI Source: https://github.com/conviu/conviu-skills/blob/main/README.md Use these commands to install skills into supported AI tools or list available integrations. ```bash npx conviu-agent init --ai cursor # one tool npx conviu-agent init --all # every supported tool npx conviu-agent list # list supported tools ``` -------------------------------- ### Install Conviu Agent via Claude Code Source: https://github.com/conviu/conviu-skills/blob/main/README.md Commands to add the marketplace and install the conviu-agent plugin within the Claude Code environment. ```text /plugin marketplace add conviu/conviu-skills /plugin install conviu-agent@conviu-skills ``` -------------------------------- ### Conviu Agent CLI Commands Source: https://github.com/conviu/conviu-skills/blob/main/cli/README.md Use these commands to manage the installation of the Conviu Agent skill across supported AI coding tools. ```bash npx conviu-agent init --ai cursor # install for one tool npx conviu-agent init --all # install for every supported tool npx conviu-agent uninstall --ai cursor # remove from one tool (or --all) npx conviu-agent list # list supported tools ``` -------------------------------- ### Repository Directory Structure Source: https://github.com/conviu/conviu-skills/blob/main/README.md Visual representation of the project file hierarchy and configuration locations. ```text conviu-skills/ ├── .claude-plugin/ │ └── marketplace.json # marketplace manifest (list of plugins) ├── plugins/ │ └── conviu-agent/ │ ├── .claude-plugin/ │ │ └── plugin.json # plugin manifest │ └── skills/ │ └── conviu-agent/ │ ├── SKILL.md # skill entry point │ └── references/ # detailed playbooks and reference material ├── cli/ # npx installer for other AI tools │ ├── index.mjs │ └── platforms.json # per-tool target paths ├── package.json # npm package (bin: conviu-agent) ├── skill.json # skill metadata + supported platforms ├── context7.json # Context7 indexing configuration ├── README.md └── LICENSE ``` -------------------------------- ### Conviu Product Data Flow Diagram Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/SKILL.md Visual representation of the data lifecycle from e-shop import to platform export. ```text E-SHOP / SUPPLIER ──▶ IMPORT ──▶ products in Conviu ──▶ EXPORT ──▶ Platform / channel feed URL, FTP, data source items (products data Zboží, Heureka, Sheet, API, upload or orders) writer job Google, Glami, FTP… ``` -------------------------------- ### Sorting Configuration Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md Define sorting order using field and order keys within an object. ```json { "field": "lastImportedAt", "order": "DESC" } ``` -------------------------------- ### FQL Set Syntax Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md Use the #s suffix inside parentheses to define a set of values. ```fql field:("a;b"#s) ``` -------------------------------- ### Canonical FQL Query Structure Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md The standard format for complex filters, grouping OR-alternatives in parentheses and joining them with AND. ```text (brand:"Nike" OR brand:"Adidas") AND (salePrice:["100" TO "500"]) AND (inStock:"true") ``` -------------------------------- ### FQL Value Syntax Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md Use the #s suffix after the closing quote for single values. ```fql field:"value"#s ``` -------------------------------- ### Conviu Agent API Navigation Flow Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/SKILL.md The recommended sequence of API calls to explore organization data, modules, and job statuses. ```text whoami → get_organization / list_organizations → get_organization_modules (status of every module) → list_data_sources (imports) → list_data_writer_jobs (exports) → list_data_queries (sources) → get_* detail on the specific item ``` -------------------------------- ### get_data_writer_job_latest_download_logs Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md Retrieves recent download activity logs for a data writer job. ```APIDOC ## get_data_writer_job_latest_download_logs ### Description Fetches recent download activity to determine who has accessed the feed. ### Parameters - **dataWriterJobUid** (string) - Required - The unique identifier of the data writer job. ``` -------------------------------- ### get_data_writer_job_validation Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md Retrieves detailed information about a specific validation run using its unique identifier. ```APIDOC ## get_data_writer_job_validation ### Description Provides detailed information about a specific validation run, including the feed URL and any failure reasons if the run itself failed. ### Parameters - **uid** (string) - Required - The unique identifier of the validation (obtained from get_data_writer_job_latest_validation). ### Response - **feedUrl** (string) - The URL of the feed that was checked. - **failureReason** (string) - The reason for a validation run failure. - **failureMessage** (string) - A descriptive message regarding the validation run failure. ``` -------------------------------- ### trigger_data_writer_job_validation Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md Triggers a fresh validation run for a specific data writer job. ```APIDOC ## trigger_data_writer_job_validation ### Description Initiates a new validation process for the specified export. This is a write operation that consumes resources. ### Parameters - **uid** (string) - Required - The unique identifier of the export (data writer job). ``` -------------------------------- ### get_data_writer_job_latest_validation Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md Retrieves the latest validation status and counts for a specific data writer job. ```APIDOC ## get_data_writer_job_latest_validation ### Description Retrieves the most recent validation results for a data writer job, including error, warning, and info counts. ### Parameters - **dataWriterJobUid** (string) - Required - The unique identifier of the data writer job. ### Response - **uid** (string) - The unique identifier of the validation. - **validationId** (string) - The ID of the validation run. - **state** (string) - The current state of the validation. - **createdAt** (string) - Timestamp of creation. - **completedAt** (string) - Timestamp of completion. - **errorCount** (integer) - Number of errors found. - **warningCount** (integer) - Number of warnings found. - **infoCount** (integer) - Number of info messages found. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.