{"skill":{"slug":"opencrawl","displayName":"ConvoYield","summary":"Conversational Yield Optimization Engine — treats every bot conversation as a yield-bearing financial instrument. Five zero-cost engines detect sentiment arb...","description":"---\r\nname: convoyield\r\ndescription: >\r\n  Conversational Yield Optimization Engine — treats every bot conversation as a\r\n  yield-bearing financial instrument. Five zero-cost engines detect sentiment\r\n  arbitrage, micro-conversions, engagement momentum, dollar-value yield forecasts,\r\n  and optimal strategic plays in real-time. No external APIs. No dependencies.\r\n  Pure behavioral economics applied to conversations.\r\nversion: 1.0.0\r\nauthor: J. DeVere Cooley\r\nhomepage: https://github.com/jcools1977/Opencrawl\r\nmetadata:\r\n  openclaw:\r\n    emoji: \"📈\"\r\n    requires:\r\n      bins:\r\n        - python\r\n    os: [\"macos\", \"linux\", \"windows\"]\r\n    tags:\r\n      - revenue\r\n      - optimization\r\n      - behavioral-economics\r\n      - zero-cost\r\n      - sentiment\r\n      - conversion\r\n    platforms: [\"discord\", \"telegram\", \"whatsapp\", \"slack\", \"webchat\"]\r\n    cost: free\r\n    requires_api: false\r\n---\r\n\r\n# ConvoYield — Conversational Yield Optimization Engine\r\n\r\n> \"Every conversation is a financial instrument. ConvoYield tells you what it's worth.\"\r\n\r\n## What It Does\r\n\r\nConvoYield gives any bot a **real-time revenue intelligence layer**. On every user\r\nmessage, five engines run in parallel and produce:\r\n\r\n- **Sentiment Arbitrage** — Detects emotional gaps that create revenue opportunities\r\n  (frustration capture, competitor displacement, excitement amplification, etc.)\r\n- **Micro-Conversion Tracking** — Finds 12 types of hidden value in every message\r\n  (email captures, budget reveals, pain points, referral signals, etc.)\r\n- **Momentum Scoring** — Measures whether the conversation is gaining or losing steam\r\n- **Yield Forecasting** — Predicts the total dollar value of the conversation in real-time\r\n- **Play Calling** — Recommends from a 20-play behavioral economics playbook\r\n  (anchoring, loss framing, social proof, empathy bridges, urgency closes, etc.)\r\n\r\n## Zero Cost Guarantee\r\n\r\n- **Zero external dependencies** — Pure Python standard library\r\n- **Zero API calls** — All analysis runs locally via pattern matching and heuristics\r\n- **Zero tokens consumed** — Does not call any LLM API\r\n- **Zero infrastructure** — `pip install` and go\r\n- **<1ms per message** — Adds no latency to your bot\r\n\r\n## Quick Start\r\n\r\n```python\r\nfrom convoyield import ConvoYield\r\n\r\nengine = ConvoYield(base_conversation_value=50.0)\r\n\r\n# Process each user message\r\nresult = engine.process_user_message(\"I'm frustrated with Salesforce, it's way too expensive\")\r\n\r\nprint(result.recommended_play)       # \"competitor_displacement\"\r\nprint(result.estimated_yield)         # 89.50\r\nprint(result.recommended_tone)        # \"empathetic\"\r\nprint(result.top_arbitrage.type)      # \"frustration_capture\"\r\nprint(result.risk_level)              # 0.21\r\n\r\n# Record bot response for full state tracking\r\nengine.record_bot_response(\"I hear you. What specifically isn't working?\")\r\n\r\n# Next message — yield COMPOUNDS\r\nresult = engine.process_user_message(\"The reporting is terrible and costs $500/month\")\r\nprint(result.estimated_yield)         # 142.30 — value is growing!\r\n```\r\n\r\n## The Five Engines\r\n\r\n### 1. Sentiment Arbitrage Engine\r\n\r\nDetects 7 arbitrage patterns via lexicon-based sentiment scoring tuned for\r\ncommercial conversations:\r\n\r\n| Pattern | What It Detects | Value Signal |\r\n|---------|----------------|--------------|\r\n| `competitor_displacement` | Frustration with a named competitor | $45+ |\r\n| `frustration_capture` | General frustration with current solution | $35+ |\r\n| `excitement_amplification` | User showing enthusiasm | $25+ |\r\n| `uncertainty_anchoring` | User unsure, needs guidance | $20+ |\r\n| `urgency_premium` | Time pressure detected | $30+ |\r\n| `social_proof_hunger` | User seeking validation | $15+ |\r\n| `budget_value_stack` | User discussing budget/cost | $40+ |\r\n\r\n### 2. Micro-Conversion Tracker\r\n\r\nDetects 12 micro-conversion opportunities between \"hello\" and \"purchase\":\r\n\r\n- Email/phone capture opportunities\r\n- Budget and timeline reveals\r\n- Team size and need statements\r\n- Competitor mentions and feature requests\r\n- Referral and testimonial signals\r\n- Pain point articulations\r\n\r\nEach micro-conversion has an estimated dollar value ($0.50-$15).\r\n\r\n### 3. Momentum Scorer\r\n\r\nScores engagement momentum (-1.0 to +1.0) using four signals:\r\n- Message length trend (expanding = engaged)\r\n- Question frequency trend (asking = curious)\r\n- Emotional intensity trend (feeling = invested)\r\n- Vocabulary richness trend (elaborating = committed)\r\n\r\nLabels: `surging` | `accelerating` | `stable` | `declining` | `hemorrhaging`\r\n\r\n### 4. Yield Forecaster\r\n\r\nCombines all signals to predict a dollar value for the conversation using:\r\n- Phase multipliers (OPENING → DISCOVERY → ENGAGEMENT → NEGOTIATION → CLOSING)\r\n- Micro-conversion portfolio value\r\n- Arbitrage opportunity value\r\n- Engagement and momentum premiums\r\n- Risk assessment (0.0-1.0)\r\n\r\n### 5. Play Caller\r\n\r\nRecommends from 20 plays inspired by behavioral economics:\r\n\r\n`warm_handshake` · `pattern_interrupt` · `deep_probe` · `empathy_bridge` ·\r\n`value_stack` · `competitor_displacement` · `social_proof_deploy` ·\r\n`dopamine_ride` · `anchoring` · `loss_framing` · `budget_reframe` ·\r\n`choice_architecture` · `assumptive_close` · `urgency_close` · `soft_close` ·\r\n`momentum_recovery` · `save_attempt` · `upsell_bridge` · `referral_harvest` ·\r\n`objection_reframe`\r\n\r\n## Integration\r\n\r\nWorks with any bot framework — hook into your message handler:\r\n\r\n```python\r\nfrom convoyield import ConvoYield\r\n\r\nengine = ConvoYield()\r\n\r\ndef on_user_message(text, conversation_id):\r\n    result = engine.process_user_message(text)\r\n\r\n    # Shape your bot's response using:\r\n    # result.recommended_play     → WHAT strategy to use\r\n    # result.recommended_tone     → HOW to say it\r\n    # result.arbitrage_opportunities → WHERE the money is\r\n    # result.micro_conversions    → WHAT value to capture\r\n    # result.risk_level           → HOW careful to be\r\n    # result.estimated_yield      → HOW much is at stake\r\n\r\n    return generate_response(text, result)\r\n```\r\n\r\n## Premium Playbooks\r\n\r\nFour industry-specific playbook packs available:\r\n\r\n| Playbook | Plays | Price |\r\n|----------|-------|-------|\r\n| SaaS Sales Mastery | 25 | $49/mo |\r\n| E-Commerce Revenue Max | 22 | $39/mo |\r\n| Real Estate Closer | 20 | $79/mo |\r\n| Healthcare Engagement | 18 | $99/mo |\r\n\r\n## Revenue Model\r\n\r\nConvoYield is free and open source. Revenue comes from:\r\n\r\n1. **Premium playbooks** — Industry-specific play packs ($39-99/mo)\r\n2. **Cloud analytics** — Dashboard and yield tracking ($0/49/299/mo tiers)\r\n3. **Enterprise** — Custom playbooks, webhooks, white-label ($299/mo)\r\n\r\n## Architecture\r\n\r\n```\r\nconvoyield/\r\n├── orchestrator.py              # Main ConvoYield engine\r\n├── engines/\r\n│   ├── sentiment_arbitrage.py   # 7 arbitrage pattern detectors\r\n│   ├── micro_conversion.py      # 12 micro-conversion trackers\r\n│   ├── momentum.py              # 4-signal engagement scorer\r\n│   ├── yield_forecaster.py      # Dollar-value yield prediction\r\n│   └── play_caller.py           # 20-play behavioral economics playbook\r\n├── models/\r\n│   ├── conversation.py          # ConversationState, Turn, Phase\r\n│   └── yield_result.py          # YieldResult, ArbitrageOpportunity\r\n├── playbooks/                   # 4 premium industry packs (85 plays)\r\n├── coin/                        # ConvoCoin — Proof-of-Yield blockchain\r\n└── cloud/                       # Telemetry client for analytics\r\n```\r\n\r\n## Tests\r\n\r\n40 tests across 7 suites — all passing:\r\n\r\n```bash\r\npython -m pytest tests/ -v\r\n```\r\n","topics":["Financial"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":777,"installsAllTime":29,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772384888429,"updatedAt":1778994288899},"latestVersion":{"version":"1.0.0","createdAt":1772384888429,"changelog":"Initial release","license":null},"metadata":{"setup":[],"os":["macos","linux","windows"],"systems":null},"owner":{"handle":"jcools1977","userId":"s17ebw5h443w8hw0qvntmyrad1884ra1","displayName":"John DeVere Cooley","image":"https://avatars.githubusercontent.com/u/75928463?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089733302}}