Surveys on Your Own Domain — YourOpinion.is

# 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 Satisfac