Text-Based Import Protocol
This protocol provides a way for AI agents to create functional surveys for YourOpinion.is using standard Markdown. Instead of constructing a complex JSON object, an agent generates a structured Markdown string and encodes it into a single clickable URL. Clicking the link reconstructs the survey instantly in YourOpinion import page.
It requires no agent setup, not API keys, and no account. Any Large Language Model (LLM) can follow these instructions to create a functional survey in seconds.
How it Works
- Copy the prompt below and paste it into your AI agent.
- The agent generates a Markdown survey and returns a clickable import link.
- Click the link - Your survey loads instantly into YourOpinion.is.
Instructions for your AI Agent
Copy this prompt and paste it into ChatGPT, Claude, Gemini, or any LLM:
# YourOpinion.is Import Protocol
## Description
This tool allows AI agents to generate rich, multi-page surveys by creating a clickable "Import Link" for the user.
## How It Works
1. **You (the Agent)** generate a Markdown document representing the survey.
2. **You** URL-encode the Markdown text.
3. **You** construct the final link: `https://youropinion.is/import#<encoded-markdown>`
4. **The User** clicks the link, and YourOpinion.is instantly converts it into a functional survey.
## Output to user
1. Always show the final markdown to the user.
2. Below the markdown add the final constructed URL.
3. Always also return a link to https://youropinion.is/import for manual import if the generated link does not work.
## The Survey Markdown Dialect
Write the survey using standard Markdown syntax. Use the following mapping:
### Structure
- `# Title` : (Header 1) Use this for the **Survey Title** (first line only).
- `---` : (Horizontal Rule) Use this to create a **Page Break** between questions.
- `> Logic` : (Blockquote) Use this to define **Conditional Logic** or internal notes (e.g., "If Yes, skip to end").
### Question Types
The Import Agent infers the input type from your text context. You do not need explicit type definitions.
- **Choice Question:** Use a Header 3 (`###`) followed by a bulleted list (`- Option`).
- **Multi-Select:** Use a Header 3 (`###`) followed by checkboxes (`- [ ] Option`).
- **Text/Essay:** Use a Header 3 (`###`) followed by a blank line or placeholder (e.g., `[___]`).
- **Rating/Scale:** Use a Header 3 (`###`) and include the range in text (e.g., "Rate 1-10" or "On a scale of 0 to 5").
## Constraints
- **Length:** Keep the encoded URL under **4KB** (approx. 500 words of Markdown) to ensure browser compatibility.
- **Fallback:** If the survey is very long, provide the raw Markdown to the user and tell them to copy-paste it manually.
## Example Output
(Generate the link based on this structure)
```markdown
# Customer Satisfaction
> Context: Post-purchase feedback loop.
### How would you rate your experience?
(Scale 1-10)
### What did you buy?
- Shoes
- Jacket
- Accessories
> If "Accessories", skip to the end.
---
### Any final feedback?
[Write here]
```